From owner-freebsd-doc Tue Nov 3 02:07:56 1998 Return-Path: Received: (from majordom@localhost) by hub.freebsd.org (8.8.8/8.8.8) id CAA18636 for freebsd-doc-outgoing; Tue, 3 Nov 1998 02:07:56 -0800 (PST) (envelope-from owner-freebsd-doc@FreeBSD.ORG) Received: from firewall1.lehman.com (firewall1.Lehman.COM [192.147.65.82]) by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id CAA18630 for ; Tue, 3 Nov 1998 02:07:53 -0800 (PST) (envelope-from nclayton@lehman.com) From: nclayton@lehman.com Received: from relay.lehman.com by firewall1.lehman.com (8.8.6/8.8.6) id FAA15617; Tue, 3 Nov 1998 05:07:35 -0500 (EST) Received: from cmgrelay1.messaging-svcs.lehman.com by relay.lehman.com (4.1/LB-0.6) id AA18457; Tue, 3 Nov 98 05:07:02 EST Received: from lonmailhost.lehman.com by cmgrelay1.messaging-svcs.lehman.com (8.8.5/8.8.5) id FAA18615; Tue, 3 Nov 1998 05:06:59 -0500 (EST) Received: from lonadminvnm.lehman.com by lonmailhost.lehman.com (SMI-8.6/Lehman Bros. V1.5) id KAA09222; Tue, 3 Nov 1998 10:06:57 GMT Received: from lonadmin80.lehman.com by lonadminvnm.lehman.com (4.1/Lehman Bros. V1.6) id AA17597; Tue, 3 Nov 98 10:06:57 GMT Received: by lonadmin80.lehman.com (SMI-8.6/Lehman Bros. V1.5) id KAA22183; Tue, 3 Nov 1998 10:06:56 GMT Message-Id: <19981103100655.Q20122@lehman.com> Date: Tue, 3 Nov 1998 10:06:55 +0000 To: Kim , freebsd-doc@FreeBSD.ORG Subject: Re: Greetings, docs team! References: <199811012044.MAA20293@time.cdrom.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.91.1i In-Reply-To: <199811012044.MAA20293@time.cdrom.com>; from Kim on Sun, Nov 01, 1998 at 12:44:43PM -0800 Organization: Lehman Brothers Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Hi Kim, On Sun, Nov 01, 1998 at 12:44:43PM -0800, Kim wrote: > I've taken a break from contracting to (a) regain my sanity and > (b) do some work on the FreeBSD docs project. I've been working > on a new (separate) Installation and Configuration Guide(s), and > a docplan/outline for a complete standard UNIX format docset. Have you seen the (v. recent) discussion I kicked off about this? > I hadn't seen much happening on the docs project until very > recently -- other than the massive and heroic effort to convert the > handbook to the O'Reilly docbook DTD (!yow!) -- Thanks. It's been keeping me busy :-) > so I've just been off in a corner doing my own thing. Now it looks > like some major organized effort is shaping up to redo the docs, > so I thought I'd let you know I'm around and available to do some work. OK. If the next round of discussion about my proposed changes is positive I'm going to 1. Finish getting the DocBook Handbook to the point where it can replace the LinuxDoc one. 2. Implement the framework for the new documentation set -- I think we've probably gone beyond the realms of a Handbook now. The framework will use a lot of the content from the existing Handbook. Equally, there will be a lot of sparse areas, and sections which will need some rewriting. I think that's the majority of the work that will need doing. In the mean time, any comments you have about my proposed changes would be very welcome. > I also have some ideas about how to recruit new writers and maybe even > possibly get some actual real ($$) resources for the docs > project. Sounds good. > I'll send that out in a separate message. Also, I am > interested in helping out with the marketing pubs end of the spectrum > (press releases, glossies, datasheets, whitepapers, advertising, > etc.). If anyone else out there would like to work on that (or already > is!), you can email me at antwerp@time.cdrom.com. Also sounds good. There's effort happening on the advocacy mailing list (advocacy@freebsd.org) right now about press releases and the like. I can't speak for them, but it might be worth getting in touch with the folks behind freebsdmall.com as well. > [A draft of the install guide will be posted around the end of next week > on my webpage. This project is separate from the handbook, but if > you want to incorporate it, go for it.] There's at least one other guide floating around, Randy Pratt's at Have you seen it? Perhaps the two of you could collaborate? N -- --+==[ Systems Administrator, Year 2000 Test Lab, Lehman Brothers, Inc. ]==+-- --+==[ 1 Broadgate, London, EC2M 7HA 0171-601-0011 x6492 ]==+-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message