From owner-freebsd-doc@FreeBSD.ORG Mon Jun 16 16:17:52 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3D8C137B401; Mon, 16 Jun 2003 16:17:52 -0700 (PDT) Received: from abigail.blackend.org (blackend.org [212.11.35.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7A31243FAF; Mon, 16 Jun 2003 16:17:50 -0700 (PDT) (envelope-from marc@blackend.org) Received: from nosferatu.blackend.org (nosferatu.blackend.org [192.168.10.205]) by abigail.blackend.org (8.12.3/8.12.3) with ESMTP id h5GLF5bS053635; Mon, 16 Jun 2003 23:15:05 +0200 (CEST) (envelope-from marc@abigail.blackend.org) Received: from nosferatu.blackend.org (localhost [127.0.0.1]) h5GLF6LP002429; Mon, 16 Jun 2003 23:15:06 +0200 (CEST) (envelope-from marc@nosferatu.blackend.org) Received: (from marc@localhost) by nosferatu.blackend.org (8.12.9/8.12.9/Submit) id h5GLF6qe002428; Mon, 16 Jun 2003 23:15:06 +0200 (CEST) (envelope-from marc) Date: Mon, 16 Jun 2003 23:15:05 +0200 From: Marc Fonvieille To: Tom Rhodes Message-ID: <20030616211505.GC550@nosferatu.blackend.org> References: <20030616171455.GB550@nosferatu.blackend.org> <20030616132114.368a354c.trhodes@FreeBSD.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20030616132114.368a354c.trhodes@FreeBSD.org> User-Agent: Mutt/1.4i X-Useless-Header: blackend.org X-Operating-System: FreeBSD 5.1-CURRENT cc: docs@FreeBSD.org Subject: Re: Removal of some mini-faqs in the Handbook. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 16 Jun 2003 23:17:52 -0000 On Mon, Jun 16, 2003 at 01:21:14PM -0400, Tom Rhodes wrote: > > This was discussed a little bit ago, and is also listed as a handbook > task which I'm currently working on. Recently there was a small > discussion about moving the FAQ into the handbook, near the end of > each chapter, and then add a way to extract these entries for the > FAQ. This would give us a build_with_faq or build_without_faq type > of setup. > > This is not definate though. > No, I'm not talking about that. > My reply on the following is: > > an "ugly mess". Where it was easy to find the information for the > > reader, we have now a big set of "paras" not easy to read. > > A few of my replacement "paras" were posted on the -doc list and did > bring a reply from Simon L. Nielson, Jim, and someone else who I > just cannot remember right now for some reason. During the time I > was doing this, you never sent a reply to me. I'm talking about Section "6.8.3.2 Troubleshooting" and I do not remember any mail about it on -doc, but I can be wrong on that point. > If you think it is > an "ugly mess", then could you explain this opinion to me? Perhaps > a patch, cut & paste it into an email then post your comments, anything. > I'll certainly look at it. Thanks! > I know very well that section since I wrote it :) I just noted the removal of the mini-faq when I sent an user to the section 6.3 (I do not read every commit mail). The person complained about the Troubleshooting section layout. If you really think the new layout is better than the previous one, then that's Ok. My opinion is not: "keep the old layout", I just want something easy to read. By the way, you should keep the info about performance issues with autoselect mode on some NICs since this mode is not seen by users as an "incorrect network settings". For mail-trouble.html, I just hope it will be treated in a better way. Marc