Date: Mon, 1 Jul 1996 15:16:50 -0600 From: Sean Kelly <kelly@fsl.noaa.gov> To: jhs@FreeBSD.org Cc: doc@FreeBSD.org Subject: Re: share/doc/FAQ/obj/freebsd-faq.html Message-ID: <199607012116.VAA13753@gatekeeper.fsl.noaa.gov> In-Reply-To: <199607011633.SAA13589@vector.jhs.no_domain>
index | next in thread | previous in thread | raw e-mail
>>>>> "Julian" == "Julian H Stacey" <jhs@FreeBSD.org> writes:
Julian> Based on current src/ Quick Suggestion: Add clickable
Julian> HREFs right at end of freebsd-faq.html for - Questions
Julian> (mailto:questions@freebsd.org) - FAQ Errors, (mailto: doc
Julian> editors)
Good idea.
Julian> Style & Colloquialisms: 7.3. Hey! Chmod ... 7.6. Hey! My
Julian> printer is slow as a dog ... This style makes the FAQ
Julian> harder to quickly scan when people look to see if a
Julian> question is in the FAQ before posting.
Quite right; it probably comes from the unofficial FAQ style that
(d)evolved out of Usenet newsgroups. It's not terribly useful, is it?
Furthermore, the handbook has a *strict* rule about not using
something has harmless as contractions (supposedly to facilitate
understanding by nonnative English speakers) yet in the FAQ it's a
free-for-all.
My favorite way to use the FAQ: full-text search.
(That's definitely an indication that something's wrong.)
Julian> Daft answers don't deserve to clutter the index & waste
Julian> space forever: Delete: `7.20. ... 7.21
I could hardly believe that these questions were even addressed!
Julian> Longer Term Suggestion: Reorder the words in the FAQ
Julian> sections titles, EG: Printer, colour,
Julian> driver: fails when blah blah Printer, postscript: filters
Julian> available Printer, parallel port: interrupt config
Julian> Printer, serial: interface parameters
Excellent!
--
Sean Kelly
NOAA Forecast Systems Laboratory kelly@fsl.noaa.gov
Boulder Colorado USA http://www-sdd.fsl.noaa.gov/~kelly/
help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?199607012116.VAA13753>