From owner-freebsd-doc Wed Jan 31 12:35:14 2001 Delivered-To: freebsd-doc@freebsd.org Received: from odin.ac.hmc.edu (Odin.AC.HMC.Edu [134.173.32.75]) by hub.freebsd.org (Postfix) with ESMTP id 1DF9F37B503; Wed, 31 Jan 2001 12:34:55 -0800 (PST) Received: (from brdavis@localhost) by odin.ac.hmc.edu (8.11.0/8.11.0) id f0VKYsJ02042; Wed, 31 Jan 2001 12:34:54 -0800 Date: Wed, 31 Jan 2001 12:34:54 -0800 From: Brooks Davis To: Nik Clayton Cc: John Reynolds~ , Beau , doc@FreeBSD.ORG Subject: Re: BSD Documentation Message-ID: <20010131123454.C23401@Odin.AC.HMC.Edu> References: <14966.58186.247528.426703@hip186.ch.intel.com> <20010131013258.A12527@canyon.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <20010131013258.A12527@canyon.nothing-going-on.org>; from nik@FreeBSD.ORG on Wed, Jan 31, 2001 at 01:32:59AM +0000 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Wed, Jan 31, 2001 at 01:32:59AM +0000, Nik Clayton wrote: > However, people don't seem to be noticing this, nor do they notice the > text at the front of the Handbook, and other docs, which explains this > as well. At this point, I'd welcome suggestions for ways to make this > information more obvious. I think this is a layout problem. I never remember to read that paragraph at the top when I'm looking for the list. It's just too well hidden is a bunch of stuff that just screams "I'm a bunch of legal BS you don't want to read!" More obvious delimitation from the legal stuff would certaintly help though I'm not sure how to do it. On option would be to take an idea from a number of FAQs and add a section 0 to the document with meta information like legal stuff, where to get other versions, etc. -- Brooks -- Any statement of the form "X is the one, true Y" is FALSE. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message