Fragmentation in Linux Documentation?

Karsten Wade kwade at
Mon May 21 10:35:44 UTC 2007

A belated follow-up that has been sitting on my desktop ...

On Sat, 2007-04-21 at 22:45 +0200, Robert M. Albrecht wrote:

> Has docbook something like ifdef ?

Yes, although the exact mechanism for XML escapes my ability to recall
at the moment.

> So a
> make fedora
> would produce the manuals in Fedora oder Ubuntu flavor ?

Right.  I think the mechanics of sharing a common base with distro
variants is the easy part.

The hard part is stuff such as - different community styles; different
expectations of quality, quantity, etc.; different writing styles;
difficulty in creating an upstream with the authority to enforce style
guidelines, etc.

> Another problem I hit several times is to keep various languages in
> sync. If you don`t see excatly what changed in the original-document,
> it`s near to impossible.
> So keeping the documentation per chapter or even smaller in a cvs would
> help.

We typically do this modularity for DocBook, sometimes down to the
<section>-per-file.  Not sure how this would work with the POT file;
perhaps there could be some way to group/ungroup/regroup from modular

- Karsten
   Karsten Wade, 108 Editor       ^     Fedora Documentation Project 
 Sr. Developer Relations Mgr.     |           |          gpg key: AD0E0C41
////////////////////////////////// \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
URL: <>

More information about the fedora-docs-list mailing list