From owner-freebsd-doc Tue Sep 12 16:44:37 2000 Delivered-To: freebsd-doc@freebsd.org Received: from ice.cream.org (ice.cream.org [195.8.71.30]) by hub.freebsd.org (Postfix) with SMTP id 6A48637B422 for ; Tue, 12 Sep 2000 16:44:34 -0700 (PDT) Received: (qmail 30240 invoked from network); 12 Sep 2000 23:44:27 -0000 Received: from ice.cream.org (HELO cream.org) (195.8.71.30) by ice.cream.org with SMTP; 12 Sep 2000 23:44:27 -0000 Content-Length: 1847 Message-ID: X-Mailer: XFMail 1.3 [p0] on FreeBSD X-Priority: 3 (Normal) Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 8bit MIME-Version: 1.0 In-Reply-To: Date: Wed, 13 Sep 2000 00:44:33 +0100 (BST) From: Andrew Boothman To: doc@FreeBSD.org Subject: Re: docs/20794: Request 2 good documents under people.freebsd.or Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Right, I think I've finished marking up those two documents. The originals can be found on : http://people.freebsd.org/~nsayer/bdg-ipfw.txt http://people.freebsd.org/~alfred/pxe My versions in Docbook, together with their HTML counterparts, can be found on : http://ukug.uk.freebsd.org/~andrew/docproj/ The "Filtering Bridges" one hasn't changed since I last asked the list for comments, so I really want you to look at the "PXE Installs" document. I've got serveral issues with it at present : 1) I need to find a publication date for the original document (will contact author) 2) What do you think of the introduction? I didn't really know what to put in there. 3) There's a bit of an 'advert' in the first section, where the author says he could be contacted to quote on a project to write a netboot system for someone who wants to pay. Do we normally allow this sort of thing? 4) There are some links to download files (which I still have to get URLs for) at present the files live on people.freebsd.org/~alfred should they stay there or is there a more permanent home for things like this on ftp.freebsd.org? 5) What is the appropriate way to markup comments alongside commands that the user is to type in? I just left it inside the tag, but could that confuse the user? Unfortunately the standard '#' symbol for comments is also the root prompt. :-( 6) Overall how do you find the layout of the article. I certainly found this one more difficult to markup, getting all the indentation right with all those nested 's, 's and 's really sent my head spinning! :-) 7) Oh, and how should the 'terminology' section be marked up? I threw a table around it, but I don't think it looks right. Right, that's it. All comments and suggestions please! --- Andrew Boothman http://sour.cream.org To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message