On Thursday 2002-08-01 19:42 -0700, dwx wrote: > see http://bugzilla.mozilla.org/show_bug.cgi?id=53153 > > For consistancy with (English) documentation, I think we need a style guide to > word choices and grammar. Below is just a short list of words that we should > watch out for. Feel free to add more entries. Also feel free to disagree with > me.
http://developer.apple.com/techpubs/macosx/Essentials/AquaHIGuidelines/AppBTerms/index.html is an example of such a style guide (it links to another guide that may be more thorough, although it's in PDF format). For what types of documentation are you suggesting we need such a style guide? I can see the use of one for end-user documentation and for web developer documentation, although the two would probably need different guides. Then again, I only really see the advantage of such a level of consistency in a world where we have more thorough docs than we do now. -David -- L. David Baron <URL: http://www.people.fas.harvard.edu/~dbaron/ >
