From owner-freebsd-stable Tue Mar 11 19:38:21 2003 Delivered-To: freebsd-stable@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E161837B48F; Tue, 11 Mar 2003 19:38:18 -0800 (PST) Received: from smtp.acd.net (smtp.acd.net [207.179.102.146]) by mx1.FreeBSD.org (Postfix) with ESMTP id 565E843FDD; Tue, 11 Mar 2003 19:38:17 -0800 (PST) (envelope-from taxman@ACD.NET) Received: from 207.179.77.28 ([207.179.77.28]) by smtp.acd.net with Microsoft SMTPSVC(5.0.2195.5329); Tue, 11 Mar 2003 22:38:09 -0500 From: taxman To: freebsd-doc@freebsd.org, Doug Barton , David Schultz Subject: Re: RELENG_4 Tag... Date: Tue, 11 Mar 2003 22:41:14 -0500 User-Agent: KMail/1.5 Cc: "Bruce A. Mah" , Wes Peters , John Von Essen , freebsd-stable@FreeBSD.ORG, freebsd-doc@freebsd.org References: <20030310094853.L3006-100000@beck.quonix.net> <20030311211550.GA7157@HAL9000.homeunix.com> <20030311170704.B1461@znfgre.tberna.bet> In-Reply-To: <20030311170704.B1461@znfgre.tberna.bet> MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit Content-Disposition: inline Message-Id: <200303112241.14940.taxman@acd.net> X-OriginalArrivalTime: 12 Mar 2003 03:38:09.0977 (UTC) FILETIME=[CD51BA90:01C2E848] Sender: owner-freebsd-stable@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG On Tuesday 11 March 2003 08:12 pm, Doug Barton wrote: > [Follow-ups set to -doc] > > On Tue, 11 Mar 2003, David Schultz wrote: > > That section looks pretty good to me, so you have my apologies. > > Some of the sections are much worse, though. For instance, take a > > look at section 18 (Advanced), which is a little bit better than > > it used to be but still wrong in many areas. I asked about > > interest in updating the FAQ last April, and the response I got > > was that people would accept updates to it, but basically everyone > > wanted to focus on the Handbook. I assumed that this was because > > people preferred the layout of the Handbook as a better way to > > find information. > > Well that's just silliness... if you have contributions to the FAQ, file > PR's at least. That way the issue can be addressed in real terms (instead > of, "What would happen if I?"). > > But seriously folks, I suggested a while back that "we" reorganize the > useful information in the FAQ so that it lives in the appropriate location > in the handbook, and turn the FAQ itself into links back to the handbook. > At the time I was laughed out of court for a couple reasons, not the least > of which was resources. But we've got a pretty solid core of doc > committers nowadays, perhaps it's time to revisit this idea? I for one, wholeheartedly support that idea. There is simply too much information in the FAQ sometimes (considering its purpose of being a FAQ and not a research tool) and knowing where to find the answer can be really hard because there is so much there. But if the information was in the handbook I believe it would be a lot more useful. Especially using your idea of linking to the appropriate handbook section. my .02 Tim To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-stable" in the body of the message