Date: Fri, 4 Oct 2002 21:27:57 -0400 From: Tom Rhodes <trhodes@FreeBSD.org> To: FreeBSD-doc@FreeBSD.org Subject: Plea to the doc team Message-ID: <20021004212757.2a7e3227.trhodes@FreeBSD.org>
next in thread | raw e-mail | index | archive | help
Fellow Doc committers and contributers,
Its been said over and over the use of 'you' in technical docs looks
bad. While I'm going to be at working cleaning up the doc tree of
bad gammar (run-ons, incorrect use of semicolons, to many useless
words and fragments) I'll try to kill the use of 'you'.
My request is, if you remove the 'you' from documents you can cut
down extremly on the amount you type, the amount a reader will
read, and documentation size in general. This IMO is a good thing
and will also cut down on grammar bogons.
If you have nothing to do between classes, please print a section
of the handbook and skim it. See where we use to many words,
where paragraphs can be more clear or even where we make grammar
mistakes. Then committers please make
the changes or contributers please create a patch file for us.
We could also use some 5.0 information. Currently we seem to lack
documentation on ACPI, device.hints(5), mail clients (I'm working)
STMP auth (I'm working) and various other features.
Thanks to all who have read this far ;)
--
Tom (Darklogik) Rhodes
www.FreeBSD.org -The Power To Serve
www.Pittgoth.com -Pittgoth Discussion Portal
trhodes@{Pittgoth.com, FreeBSD.org}
PGP key by www:
http://www.pittgoth.com/~darklogik/darklogik.key
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20021004212757.2a7e3227.trhodes>