From owner-freebsd-doc  Sun Jun  3 20:41:54 2001
Delivered-To: freebsd-doc@freebsd.org
Received: from bazooka.unixfreak.org (bazooka.unixfreak.org [63.198.170.138])
	by hub.freebsd.org (Postfix) with ESMTP id BC87B37B401
	for <doc@FreeBSD.org>; Sun,  3 Jun 2001 20:41:50 -0700 (PDT)
	(envelope-from dima@unixfreak.org)
Received: from hornet.unixfreak.org (hornet [63.198.170.140])
	by bazooka.unixfreak.org (Postfix) with ESMTP
	id 43CFD3E31; Sun,  3 Jun 2001 20:41:50 -0700 (PDT)
To: chris@calldei.com
Cc: doc@FreeBSD.org
Subject: Re: FAQ patch #1: Repairing all the stuff between <question> tags 
In-Reply-To: <20010603220925.H80472@holly.calldei.com>; from chris@calldei.com on "Sun, 03 Jun 2001 22:09:25 -0500"
Date: Sun, 03 Jun 2001 20:41:50 -0700
From: Dima Dorfman <dima@unixfreak.org>
Message-Id: <20010604034150.43CFD3E31@bazooka.unixfreak.org>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org

Chris Costello <chris@calldei.com> writes:
>    Well, I'm going to try and start working on the FAQ now.  So
> I'm going to start by making it all actually questions and
> answers (rather than a vague phrases which include obscure error
> messages).  My first step was to make all the stuff between
> <question> tags into actual questions.  This is really more of a
> style thing, but it's a good place to start.
> 
>    Note that there will be a second commit after this one to
> match the answers to the questions which have been changed if
> necessary.
> 
>    Please give me suggestions or reviews as to what needs to
> change with my patch.
> 
>      http://people.freebsd.org/~chris/faq-question.patch

I haven't read through the whole thing, but so far it looks good.
Please make sure to properly indent continuation lines though.  E.g.:

	@@ -1027,8 +1027,8 @@
	
	       <qandaentry>
	         <question id="translation">
	-          <para>I'd like to translate the documentation into
	-            Friesian.</para>
	+          <para>What do I need to do to translate a FreeBSD document into
	+          my native language?</para>
	         </question>

The second added line should be indented by two spaces.

Also, what happened to your plans to reorganize the FAQ?  You were
going to do this after 4.3-RELEASE, but it never happened.  Are you
still planning to do that?  If so, when?

Thanks,

					Dima Dorfman
					dima@unixfreak.org

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message