From owner-freebsd-doc Sat May 6 13: 3: 9 2000 Delivered-To: freebsd-doc@freebsd.org Received: from rock.ghis.net (rock.ghis.net [209.222.164.7]) by hub.freebsd.org (Postfix) with ESMTP id A97A237BD22 for ; Sat, 6 May 2000 13:03:05 -0700 (PDT) (envelope-from will@blackdawn.com) Received: from argon.blackdawn.com (02-134.dial.008.popsite.net [209.69.195.134]) by rock.ghis.net (8.9.3/8.9.3) with ESMTP id NAA55626 for ; Sat, 6 May 2000 13:03:04 -0700 (PDT) Received: by argon.blackdawn.com (Postfix, from userid 1000) id 53EA11918; Sat, 6 May 2000 16:02:54 -0400 (EDT) Date: Sat, 6 May 2000 16:02:54 -0400 From: Will Andrews To: doc@freebsd.org Subject: Re: Developer's handbook suggestion Message-ID: <20000506160254.L55274@argon.blackdawn.com> References: <20000506173121.I16612@daemon.ninth-circle.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0.1i In-Reply-To: <20000506173121.I16612@daemon.ninth-circle.org>; from asmodai@wxs.nl on Sat, May 06, 2000 at 05:31:21PM +0200 X-Operating-System: FreeBSD 5.0-CURRENT i386 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Sat, May 06, 2000 at 05:31:21PM +0200, Jeroen Ruigrok/Asmodai wrote: > However I am not particulary happy with the current ordering of the > chapters as per > http://people.freebsd.org/~nik/developer-handbook/index.html. This is > an attempt to get it more in a logical order. I basically took Nik's > URL, mine at http://home.wxs.nl/~asmodai/pdp, and a ton of books to come > up with a decent order. I would love to see the PDP take off as an officially endorsed documentation project in the repository, as it would help bring new src hackers to the FreeBSD team! Unfortunately, most coders don't feel like actually writing documentation, so doc-foos have to extract information about X, Y, or Z function and where it gets information, etc. I myself am guilty of this ubiquitous problem. :) of course, cxref, doc++, and a few other things help simplify the job... -- Will Andrews GCS/E/S @d- s+:+>+:- a--->+++ C++ UB++++ P+ L- E--- W+++ !N !o ?K w--- ?O M+ V-- PS+ PE++ Y+ PGP+>+++ t++ 5 X++ R+ tv+ b++>++++ DI+++ D+ G++>+++ e->++++ h! r-->+++ y? To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message