From owner-freebsd-doc Fri Mar 10 16:28:38 2000 Delivered-To: freebsd-doc@freebsd.org Received: from darius.concentric.net (darius.concentric.net [207.155.198.79]) by hub.freebsd.org (Postfix) with ESMTP id 9ED1537C0C4 for ; Fri, 10 Mar 2000 16:28:34 -0800 (PST) (envelope-from ursa@cris.com) Received: from newman.concentric.net (newman.concentric.net [207.155.198.71]) by darius.concentric.net (8.9.1a/(98/12/15 5.12)) id TAA09378; Fri, 10 Mar 2000 19:28:29 -0500 (EST) [1-800-745-2747 The Concentric Network] Received: from UrsaMajor.Ursa.com (ts004d43.atl-ga.concentric.net [64.1.54.199]) by newman.concentric.net (8.9.1a) id TAA15490; Fri, 10 Mar 2000 19:28:27 -0500 (EST) Message-ID: <38C99305.41C67EA6@cris.com> Date: Fri, 10 Mar 2000 19:28:38 -0500 From: amg X-Mailer: Mozilla 3.04Gold (X11; I; FreeBSD 2.2.8-RELEASE i386) MIME-Version: 1.0 To: FreeBSD-doc@FreeBSD.ORG Subject: documentation Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hopefully, this is going to the right people. I'm a C/UNIX programmer, and, over the years, I've had my snout in a lot of bad code. And, what all of this bad code had in common was lack of (any kind of) documentation. Because of this I am, expectedly, big on documentation. Toward that end, I'd like to suggest an additional doco approach, to augment the handbook.ascii, which, by the way, is loaded with lots of good information. Despite my not having a high opion of linux, their HOWTO series is both a good idea as well as most of it being well written. It seems that a lot of it is already written and just needs to gone over to insure that it fits FreeBSD. Credit should, of course, be given to the linux team. Additionlly, I would like to offer to the Documen- tation team, a script that I have written to use with my CD burner. It replaces the two scripts that are located in /usr/share/examples/worm: makecdfs.sh and burncd.sh, neither of which is well commented nor a joy to use. I was envisioning a CD-R HowTO or miniHowTo which would have input from users about their methods of using their burners and any scripts or support programs or files that they have generated. I hope that you'll find some of this of use. august ursa@cris.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message