XML style guide

Karsten Wade kwade at redhat.com
Thu Sep 15 00:57:12 UTC 2005


Mark Johnson and I are working on an update to the DocBook XML style
guidelines.  These are currently mixed between the Fedora Documentation
Guide[1] and the example-tutorial in CVS.

Our objective is to make a complete, unified, canonical, and community-
influenced set of style guidelines.

Our other objective is to use these guidelines internally.  One of the
interesting effects of having a good toolchain and documentation about
how-to document is that FDP is being used by people for internal or
other non-Fedora documentation needs.

I think that is *so* cool.

Open source content is more than just technical talk.  It includes
marketing talk, project management talk, process talk, style, usability,
and design talk, philosophy talk ...  well, that last one is at the core
of the free software movement, an open, conversant philosophy.
Anyway ...

You are watching this DocBook XML style guidelines unfold in front of
you on this mailing list, with your participation encouraged.

Thanks - Karsten

[1] http://fedora.redhat.com/participate/documentation-guide/
-- 
Karsten Wade, RHCE * Sr. Tech Writer * http://people.redhat.com/kwade/
gpg fingerprint:  2680 DBFD D968 3141 0115    5F1B D992 0E06 AD0E 0C41   
                       Red Hat SELinux Guide
http://www.redhat.com/docs/manuals/enterprise/RHEL-4-Manual/selinux-guide/
-------------- 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/20050914/de0ea634/attachment.sig>


More information about the fedora-docs-list mailing list