Mailing-List: contact docs-help@httpd.apache.org; run by ezmlm
Precedence: bulk
Reply-To: docs@httpd.apache.org
Received-SPF: pass (asf.osuosl.org: domain of jslive@gmail.com designates
 66.249.82.231 as permitted sender)
DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws;
        s=beta; d=gmail.com;
        h=received:message-id:date:from:sender:to:subject:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references:x-google-sender-auth;
        b=IR/L+E6f7WTuCYWO9FSG2VTYIOA2BmRuZhnH+MP3V7RPORxX1YaiMbFmG+mOkw4AkwA2Buz68Mb3jkCF3qBuErsdwig2ozJxO9M/EGSJMQc6XyitGxTAdnMklO3GwyW6AMpJKH+Z1mGIy5BdADIJR0ZQuCY5jZHFudURGik2hnE=
Message-ID: <e498c1660608080650w3fba57ecodefe7ae0c33ad1e0@mail.gmail.com>
Date: Tue, 8 Aug 2006 09:50:18 -0400
From: "Joshua Slive" <joshua@slive.ca>
Sender: jslive@gmail.com
To: docs@httpd.apache.org
Subject: Re: 2.2 FAQ Docs
In-Reply-To: <44D87679.6080301@pc-tony.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
References: <44D87679.6080301@pc-tony.com>

On 8/8/06, Tony Stevenson <tony@pc-tony.com> wrote:
>
>  Hi all,
>
>  I am looking at the FAQ for 2.2, and looking back at the old 1.3 version
> for a comparison.
>  I will submit some patches and updates for the 2.2 version shortly, but I
> wanted to gauge opinion first.
>
>  I like the way that the 1.3 FAQ was broken down into more
> topics/categories, and I think this helps people who are looking in a
> certain topic range.
>  Specifically things like:
>
>
>
> Building, and Installation
> Configuration
> Error Log
> Features (SSI, ModRewrite, SSL, etc)
>  I already have a handful of items that can be broken down into these
> topics, and be added to the FAQ.
>  A lot of these items have been gleamed from time in #apache, or within the
> course of my experimentation :)
>
>  So thoughts, and comments appreciated.

Go for it.  The 2.2 FAQ is certainly under-loved.

One note: My philosophy is that the existence of a huge FAQ that must
be read by every user is a symptom of insufficient or badly designed
docs.  The reason a question is frequently asked may be because the
docs don't sufficiently cover the topic, or the topic is too hard to
find in the docs.  So I would prefer not to have an enormous FAQ with
tons of text.  Instead, I would favor restricting it to the most
crucial and common questions, and answering them mainly by providing
links into the main docs.

Joshua.

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org