Date: Mon, 16 Jun 2003 13:21:14 -0400 From: Tom Rhodes <trhodes@FreeBSD.org> To: Marc Fonvieille <blackend@FreeBSD.org> Cc: docs@FreeBSD.org Subject: Re: Removal of some mini-faqs in the Handbook. Message-ID: <20030616132114.368a354c.trhodes@FreeBSD.org> In-Reply-To: <20030616171455.GB550@nosferatu.blackend.org> References: <20030616171455.GB550@nosferatu.blackend.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Mon, 16 Jun 2003 19:14:55 +0200 Marc Fonvieille <blackend@freebsd.org> 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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030616132114.368a354c.trhodes>