Bravo! On Sat, 2004-08-21 at 12:24, Paul W. Frields wrote: > I am one of the writer/editors working on the Fedora Documentation > Project <http://fedora.redhat.com/projects/docs>, and we are preparing a > set of Style Guidelines for aspiring writers and editors. In doing a > short survey of related sites, I came across the captioned guide > ("GDSG"). Since all our documentation will be licensed under the GNU > FDL, as is the GDSG, we are very interested in using portions of your > Guide as source material. Your use of the GNU FDL makes this effort > possible. > > As the individual who will likely take the lead on preparing the Fedora > Documentation Style Guidelines, I'm writing partly out of a sense of > courtesy, but also to commend you on an exceptionally concise and > readable guide. We hope that our use of the GDSG will make the process > of creating useful, contemporary Fedora documentation a more pleasant > experience for all our contributors. We also hope that we may be able to > build upon the exceptional work you've done in preparing the GDSG. > > Please feel free to contact me back, or visit our list archives at > <http://www.redhat.com/archives/fedora-docs-list/>. > > (cc: fedora-docs-list) The debian-docs list had a similar result recently, someone recommending the GDSG as a baseline for a Debian style guide. http://lists.debian.org/debian-doc/2004/08/msg00026.html This came about because of a heated discussion about sexist language. I heard about this from someone saying, "Look at these idiots on this mailing list arguing such dumb stuff!" http://lists.debian.org/debian-doc/2004/08/msg00006.html (start 1) http://lists.debian.org/debian-doc/2004/08/msg00015.html (next continuation) I think the GDSG guideline stands, and it is the one I have always used. Avoid sexist language, mainly by avoiding the third-person pronoun. We should specify that all of our docs refer to the second-person pronoun 'you.' Happy reading, Karsten -- Karsten Wade, RHCE, Tech Writer a lemon is just a melon in disguise http://people.redhat.com/kwade/ gpg fingerprint: 2680 DBFD D968 3141 0115 5F1B D992 0E06 AD0E 0C41
