From owner-freebsd-doc@FreeBSD.ORG Mon Jun 16 10:31:58 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 5FBAD37B404; Mon, 16 Jun 2003 10:31:58 -0700 (PDT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id 1B5F343FD7; Mon, 16 Jun 2003 10:31:57 -0700 (PDT) (envelope-from trhodes@FreeBSD.org) Received: from mobile.pittgoth.com (acs-24-154-229-196.zoominternet.net [24.154.229.196]) by pittgoth.com (8.12.9/8.12.9) with SMTP id h5GHVt99016185; Mon, 16 Jun 2003 13:31:56 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Mon, 16 Jun 2003 13:21:14 -0400 From: Tom Rhodes To: Marc Fonvieille Message-Id: <20030616132114.368a354c.trhodes@FreeBSD.org> In-Reply-To: <20030616171455.GB550@nosferatu.blackend.org> References: <20030616171455.GB550@nosferatu.blackend.org> X-Mailer: Sylpheed version 0.8.10claws (GTK+ 1.2.10; i386-portbld-freebsd5.1) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit 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 17:31:58 -0000 On Mon, 16 Jun 2003 19:14:55 +0200 Marc Fonvieille wrote: > Hello, > > I noted that some "mini-faqs" have been removed. I'm not against that > idea, but sometimes the solution used to replace the FAQ just looks like > 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. > > Maybe I'm totally "out" of what is a good layout, but maybe we should > think twice before doing it on all mini-faqs (I'm thinking about > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/mail-trouble.html > for example, which will be, I guess, the next "axed one"). > 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. 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. 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! -- Tom Rhodes