From owner-freebsd-doc Wed Oct 18 11:32:32 2000 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (termroom.bsdcon.org [206.55.247.2]) by hub.freebsd.org (Postfix) with ESMTP id 4CE9B37B4FE; Wed, 18 Oct 2000 11:32:22 -0700 (PDT) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.11.0/8.11.0) id e9IITRB01787; Wed, 18 Oct 2000 19:29:27 +0100 (BST) (envelope-from nik) Date: Wed, 18 Oct 2000 19:29:27 +0100 From: Nik Clayton To: Peter Brezny Cc: "'Nik Clayton'" , freebsd-doc@freebsd.org Subject: Re: How To's Message-ID: <20001018192927.A1765@canyon.nothing-going-on.org> References: <20001018070232.C9427@canyon.nothing-going-on.org> <000801c0392a$ea66f700$47010a0a@fire.sysadmininc.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <000801c0392a$ea66f700$47010a0a@fire.sysadmininc.com>; from peter@sysadmin-inc.com on Wed, Oct 18, 2000 at 01:43:23PM -0400 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Wed, Oct 18, 2000 at 01:43:23PM -0400, Peter Brezny wrote: > I do think, however, that after all the buzz in the doc mailing list, that > it may be very important to create a new subcategory of documentation. The only subcategories we have are books and articles, and the distinction is basically "Does it have more than one chapter?" Most HOWTOs would be articles with lots of subsections. However, some of the Linux ones I've seen would break nicely into multiple chapters instead. That's really the only categorisation I want to do in terms of the physical organisation. *However*, there is nothing to prevent us adding a CATEGORIES variable to the Makefiles for each document, allowing us to classify them further, and supporting this classification on the web site. All it really needs is for someone to write the infrastructure bits (hint). Given enough time, I will do this, it's a commodity in short supply. Send patches. > or as steve mentioned, have an area where anyone can contrubute anything and > then perhaps a more 'official area' where the contributions have been > reviewed and made sure to be correct, the bottom line is we need some kind > of step by step documentation, and i think to be true to the current > documentation project, it would be bad to mix it in and water down the > current hard core documentation that the super users are accustomed to. This is all presentational. At the bottom level, all the documentation, even the "Well, it's only half written, and I might not get time to finish it" stuff, belongs on the CVS tree in the doc/ subdir. If people write documentation, it will get committed. N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message