On Sun, 2004-07-04 at 05:55, Telsa Gwynne wrote:
[...snip...]
http://developer.gnome.org/documents/style-guide/locale-5.html
There are twenty topics covered there, with rules, exceptions,
bad examples and rewritten sentences. They range from some which
are good practice in any technical documentation to others which
look surprising unless you are familiar with how other languages
say things.
[...snip...]
Excellent points all, and thank you for the link. This guide mentions a
lot of ways to correct the poor style that afflicts a lot of Linux
documentation on the Web. I glanced over the GNOME guide and found
references to a number of peeves which it is designed to prevent. I
don't see an easy way of including its contents other than in whole
(which is not a problem given that it is licensed under the GFDL), but
since they're very complete in their current form that might be the most
advisable strategy. Perhaps this calls for a "part" organization in a
more comprehensive Fedora Style Guide, which might wrap up several other
guides such as the GNOME guide you mention.
I picked EoS mostly due to its copyright status in the U.S., and, I have
to admit, my personal feelings for the book. There didn't seem to be
much in it which would be odious to anyone, but certainly it's still
merely a "guide," not "law." :-)
--
Paul W. Frields, RHCE