Fragmentation in Linux Documentation?
Karsten Wade
kwade at redhat.com
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
files.
- Karsten
--
Karsten Wade, 108 Editor ^ Fedora Documentation Project
Sr. Developer Relations Mgr. | fedoraproject.org/wiki/DocsProject
quaid.108.redhat.com | 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: <http://listman.redhat.com/archives/fedora-docs-list/attachments/20070521/bfeaaa94/attachment.sig>
More information about the fedora-docs-list
mailing list