Date: Tue, 3 Nov 1998 10:06:55 +0000 From: nclayton@lehman.com To: Kim <antwerp@time.cdrom.com>, freebsd-doc@FreeBSD.ORG Subject: Re: Greetings, docs team! Message-ID: <19981103100655.Q20122@lehman.com> In-Reply-To: <199811012044.MAA20293@time.cdrom.com>; from Kim on Sun, Nov 01, 1998 at 12:44:43PM -0800 References: <199811012044.MAA20293@time.cdrom.com>
next in thread | previous in thread | raw e-mail | index | archive | help
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
<URL:http://www.freebsd.org/~rpratt/>;
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?19981103100655.Q20122>