Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 01 Jul 1996 23:39:07 +0200
From:      "Julian H. Stacey" <jhs@FreeBSD.ORG>
To:        Tim Vanderhoek <hoek@freenet.hamilton.on.ca>
Cc:        doc@FreeBSD.ORG
Subject:   Re: share/doc/FAQ/obj/freebsd-faq.html 
Message-ID:  <199607012139.XAA19679@vector.jhs.no_domain>
In-Reply-To: Your message of "Mon, 01 Jul 1996 16:51:55 EDT." <Pine.SOL.3.91.960701163727.22909A-100000@james.freenet.hamilton.on.ca> 

next in thread | previous in thread | raw e-mail | index | archive | help
Hi, Reference:
> From: Tim Vanderhoek <hoek@freenet.hamilton.on.ca> 
> 
> > 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/



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?199607012139.XAA19679>