From owner-freebsd-doc Mon Jul 1 14:44:07 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.5/8.7.3) id OAA16982 for doc-outgoing; Mon, 1 Jul 1996 14:44:07 -0700 (PDT) Received: from vector.jhs.no_domain (slip139-92-42-157.ut.nl.ibm.net [139.92.42.157]) by freefall.freebsd.org (8.7.5/8.7.3) with ESMTP id OAA16908; Mon, 1 Jul 1996 14:43:26 -0700 (PDT) Received: from vector.jhs.no_domain (localhost [127.0.0.1]) by vector.jhs.no_domain (8.7.5/8.6.9) with ESMTP id XAA19679; Mon, 1 Jul 1996 23:39:08 +0200 (MET DST) Message-Id: <199607012139.XAA19679@vector.jhs.no_domain> To: Tim Vanderhoek cc: doc@FreeBSD.ORG Subject: Re: share/doc/FAQ/obj/freebsd-faq.html From: "Julian H. Stacey" Reply-To: "Julian H. Stacey" Organization: Vector Systems Ltd. Address: Holz Strasse 27d, 80469 Munich, Germany Phone: +49.89.268616 Fax: +49.89.2608126 (later) Web: http://www.freebsd.org/~jhs/ Mailer: EXMH 1.6.7, PGP available In-reply-to: Your message of "Mon, 01 Jul 1996 16:51:55 EDT." Date: Mon, 01 Jul 1996 23:39:07 +0200 Sender: owner-doc@FreeBSD.ORG X-Loop: FreeBSD.org Precedence: bulk Hi, Reference: > From: Tim Vanderhoek > > > Daft answers don't deserve to clutter the index & waste space forever: > > Delete: > > `7.20. Has anyone done any temperature testing.....' > > the question is debatable, the answer is just wasted space. > > Delete `7.21 ...memory to make a scratchy sound?...' > > The answer is wasted space, & doesnt even mention > > the floppy media sensing head seeks in the bios. > > Bah! Go away! Those are nice questions! However, they do clutter it up > terribly. Well, rather minority /strange, but the answers have zero value, except as humour, where perhaps a dave barry chunk outside FreeBSD `du' space might be more appropriate reading :-) Part 2 of Q7.21 could even have a sensible answer, but hasnt. > I think the proper solution is to reorganize the index to the > questions. Yes > > Reorder the words in the FAQ sections titles, > > similar to the way a stores list of engineering components is listed, > > so that the index is visually scannable fast & easily. EG: > > Printer, colour, driver: fails when blah blah > > Printer, postscript: filters available > > Printer, parallel port: interrupt config > > Printer, serial: interface parameters > > Such a technical approach to it scares me. Rather, I would have a > section `hardware problems'. `Hardware Problems' would then link to a > subsection listing another 4-10 subsubsections. One of those would be > `Printer Problems'. In concept they're the same logical structure, just that mine would present more info per page, which would be nicer over a slow web link than if we only have a few items per sub index, + your struct wouldn't be so usefull when it comes to printing the whole FAQ; however either way would be an improvement for screen interactive usage. > I look at the INDEX for the FAQ, and I'm scared... It's ugly... :( Yes. It's ugliness will discourage use as an index, & so people will be tempted to post Q instead. Julian -- Julian H. Stacey jhs@freebsd.org http://www.freebsd.org/~jhs/