Return-Path: Mailing-List: contact apache-docs-help@apache.org; run by ezmlm Delivered-To: mailing list apache-docs@apache.org Received: (qmail 705 invoked from network); 21 Feb 2001 20:00:05 -0000 Received: from mail.virginia.edu (128.143.2.9) by h31.sny.collab.net with SMTP; 21 Feb 2001 20:00:05 -0000 Received: from smtp.mail.virginia.edu by mail.virginia.edu id aa07862; 21 Feb 2001 14:59 EST Received: from jcw5q (slip-5-9.acc.Virginia.EDU [128.143.7.129]) by smtp.mail.Virginia.EDU (8.9.3/8.9.3) with SMTP id OAA33554 for ; Wed, 21 Feb 2001 14:59:52 -0500 From: Cliff Woolley To: apache-docs@apache.org MMDF-Warning: Parse error in original version of preceding line at mail.virginia.edu Subject: RE: What should the FAQ contain? (was Re: Proposal: Trash the 2.0 FAQ.) Date: Wed, 21 Feb 2001 13:59:07 -0500 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit X-Priority: 3 (Normal) X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook IMO, Build 9.0.2416 (9.0.2911.0) In-Reply-To: <01e001c09c3f$ce81a710$94c0b0d0@roweclan.net> Importance: Normal X-MimeOLE: Produced By Microsoft MimeOLE V5.00.2615.200 X-Spam-Rating: h31.sny.collab.net 1.6.2 0/1000/N ---OtherBill said: > If we go with option 2 (which I support, as long as the user is first directed > at the 'showstopper' class of reports) - may I suggest we start building this > in a sightly more tree-oriented structure, rather than one (very) long list? ---David Reid said: > Perhaps something like having a main page with the showstoppers and then a > set of sub sections dealing with specific areas which can have more detail. +1. I really think this is the way to go. There's too much information to put it all in one big document, but it's also nice to have a FAQ-style summary of the issues, even if it's just references into the main documentation. A tree-style FAQ should resolve this. --Cliff