We finally got Paul's excellent work included in the Doc Guide. This
style guideline is largely derived from the GNOME Documentation Style
Guide. We have customized it, fixed some (!) errors, and generally
stood on the shoulders of giants.
Writers and especially editors should be thoroughly knowledgeable of
this:
http://fedora.redhat.com/participate/documentation-guide/ch-style.html
And should be familiar with these or the concepts embodied there:
The Elements of Style, by William Strunk. Online version:
http://bartleby.com/141/
The Chicago Manual of Style, by the University of Chicago Press. Online
version:
http://www.chicagomanualofstyle.org/
Paradigm Online Writing Assistant, maintained by Chuck Guilford, Ph.D.
Online only:
http://www.powa.org/
We'll work on following these guidelines throughout Fedora
documentation. We will all continue to make the same mistakes, no
matter how experienced we are. This is why we edit each others work and
have style guidelines to remind us of what and why.
cheers - Karsten
--
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/
It looks like the commits list is not catching authorship correctly. I
noted that Elliot's first test (README 1.3 -> 1.4) worked properly. All
commits after that seem to be authored by the list:
http://www.redhat.com/archives/fedora-docs-commits/2005-May/author.html
Can we get this fixed? I don't know who the responsible party is,
otherwise I'd mail directly. (I thought I caught something on IRC
#fedora-docs that implied Elliot doesn't take care of this part.)
--
Paul W. Frields, RHCE http://paul.frields.org/
gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717
Fedora Documentation Project: http://fedora.redhat.com/projects/docs/