From: Earnie B. <ea...@us...> - 2005-09-06 12:00:51
|
On 9:46:08 am 2005-09-06 Keith MARSHALL <kei...@to...> wrote: > Julien Lecomte wrote: > > The problem before the change is that the HOWTOs, tutorials > > and simple Q/A HOWTOs were mixed together. I remember that to > > find answers to problems I would usually click each link to open > > it in a new tab. I do realize that the problem now is that the > > FAQ seems bloated. I did (and still do) however plan to unbloat > > down to a minimum. > > The problem, from my POV, is not so much that the FAQ is bloated, > but rather that I don't think a FAQ is the most intuitive point of > reference from which to locate a HOWTO, or for that matter, a > tutorial. > IMO, a FAQ should be a short Q&A with the answer pointing to other HOWTO, tutorial or other documentation if necessary. So in fact the FAQ then becomes TOC for the rest of the documentation. Earnie |