From owner-freebsd-doc@FreeBSD.ORG Mon Apr 7 18:58:40 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id C669737B401 for ; Mon, 7 Apr 2003 18:58:40 -0700 (PDT) Received: from wantadilla.lemis.com (wantadilla.lemis.com [192.109.197.80]) by mx1.FreeBSD.org (Postfix) with ESMTP id 264CE43FBD for ; Mon, 7 Apr 2003 18:58:39 -0700 (PDT) (envelope-from grog@lemis.com) Received: by wantadilla.lemis.com (Postfix, from userid 1004) id 1556551A7B; Tue, 8 Apr 2003 11:28:37 +0930 (CST) Date: Tue, 8 Apr 2003 11:28:37 +0930 From: Greg 'groggy' Lehey To: Niklas Saers Mailinglistaccount Message-ID: <20030408015837.GH61300@wantadilla.lemis.com> References: <20030407131220.J44062@doriath.saers.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="X1xGqyAVbSpAWs5A" Content-Disposition: inline In-Reply-To: <20030407131220.J44062@doriath.saers.com> User-Agent: Mutt/1.4i Organization: The FreeBSD Project Phone: +61-8-8388-8286 Fax: +61-8-8388-8725 Mobile: +61-418-838-708 WWW-Home-Page: http://www.FreeBSD.org/ X-PGP-Fingerprint: 9A1B 8202 BCCE B846 F92F 09AC 22E6 F290 507A 4223 cc: freebsd-doc@FreeBSD.org Subject: Re: Project model X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 08 Apr 2003 01:58:41 -0000 --X1xGqyAVbSpAWs5A Content-Type: text/plain; charset=us-ascii Content-Disposition: inline On Monday, 7 April 2003 at 13:30:10 +0200, Niklas Saers Mailinglistaccount wrote: > Hi all, > > I'd like to present > http://niklas.saers.com/freebsd-model/freebsd-model.html for review. This looks excellent! The structure is very clear, though I haven't had time to check for accuracy. > Known issues: > 1) freebsd-code-model.png (the rather ugly hand-done drawing) will be > replaced soon (I'm getting help from someone a lot more skilled at drawing > than I am :) ). It serves its purpose. > 2) The reference section needs to be cleaned up (a couple references not > working properly), and the xrefs all the sudden refer to sections, so I > need to go through my compile options. > > 3) The couple of notes in brackets are for my updating of the document. > > A couple of questions before doing a send-pr, > - do you prefer another license for documentation than the standard > two-clause license? That should be fine. > - are there any good tools for DocBook XML => DocBook SGML conversion? Not that I know of, but that doesn't mean anything. A couple of suggestions: 1. Offer the document alternatively as a series of pages rather than one big web page. I personally prefer the latter, but people on a slow link might find it a bit much. 2. Find yourself a doc committer to commit it for you. It will probably be faster. Greg -- See complete headers for address and phone numbers --X1xGqyAVbSpAWs5A Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.0 (FreeBSD) iD8DBQE+kizNIubykFB6QiMRAkxhAJ9Iy40MIqPucEg2IRLrkihiCncMDwCgkCbe SgV41xqp1HneHjY8DBZQC6M= =PibY -----END PGP SIGNATURE----- --X1xGqyAVbSpAWs5A--