sorted by: recent | see : popular

Content Tagged with DocBook + linux

There are many changes on the horizon for rPath Documentation.

One of the things that team docs here has known for a while is that the rPath wiki is a fantastic tool to leverage for documentation. It’s quick. It’s easy. It allows engineers to contribute directly to the wiki. It allows community members to contribute to to the wiki.

We’ve also known for a while that this tool has a major caveat...and that is that versioned documentation is costly. For example, if we had say version 1.0 documentation of a project at wiki.rpath.com/v1/productname and version 2.0 came out, we’d have to maintain 2 separate documents with the same information in two different URI’s and 2 different name spaces. With each addition of namespace and project version, updates would be more costly and time consuming.

It’s also a bad thing that a user can search the wiki...and have the possibility of getting results from versions that they are not using...possibly information and behavior of products that no longer applies.