From owner-freebsd-doc Sat Feb 3 10:35:23 2001 Delivered-To: freebsd-doc@freebsd.org Received: from post.mail.nl.demon.net (post-11.mail.nl.demon.net [194.159.73.21]) by hub.freebsd.org (Postfix) with ESMTP id 3B67537B4EC; Sat, 3 Feb 2001 10:35:04 -0800 (PST) Received: from [212.238.54.101] (helo=freebie.demon.nl) by post.mail.nl.demon.net with smtp (Exim 3.14 #4) id 14P7WZ-0008bV-00; Sat, 03 Feb 2001 18:35:03 +0000 Received: (from wkb@localhost) by freebie.demon.nl (8.11.1/8.11.1) id f13Ib9m52127; Sat, 3 Feb 2001 19:37:09 +0100 (CET) (envelope-from wkb) Date: Sat, 3 Feb 2001 19:37:09 +0100 From: Wilko Bulte To: "Bruce A. Mah" Cc: freebsd-doc@freebsd.org, studded@dal.net, jkh@freebsd.org, wilko@freebsd.org, nik@freebsd.org Subject: Re: Request for RELNOTESng feedback Message-ID: <20010203193709.B52095@freebie.demon.nl> References: <200102021903.f12J38l60776@bmah-freebsd-0.cisco.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <200102021903.f12J38l60776@bmah-freebsd-0.cisco.com>; from bmah@freebsd.org on Fri, Feb 02, 2001 at 11:03:08AM -0800 X-OS: FreeBSD 4.2-STABLE X-PGP: finger wilko@freebsd.org Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Fri, Feb 02, 2001 at 11:03:08AM -0800, Bruce A. Mah wrote: > sees from about 10 to 4. I'm not completely happy with the way it's > turned out, and I might break out the installation-related text into its > own document. Also the back parts of the relnotes might move to the > readme document. Sounds reasonable to me. > 2. Is it time to socialize this to a larger audience, and if so, which > audience? I was thinking of something like either -current or -hackers. Yes, I think it is time. Be prepared for a debate I guess. > 3. Anyone want to help? I'm getting a little tired marking up > documents. Plus, I don't know how good my DocBook markup is. I'm not much help here, DocBook is unchartered territory for me. > 5. The next steps are something like this: > > A. Figure out how to do markup on {alpha/i386}/INSTALL.TXT > (which I just discovered) and alpha/HARDWARE.TXT. Or at the > very least, what to do with these files. > > (Jordan, can I hack on / replace INSTALL.TXT? This looks like what > goes on the liner notes for the CD.) FWIW: Jordan never shot me for hacking on alpha/INSTALL.TXT > (Wilko, we talked briefly about you doing markup for > alpha/HARDWARE.TXT. Feel up to it?) Yes. > D. Commit RELNOTESng-building magic. We should make RELNOTESng > off by default, but I don't want to delay it any longer than > necessary, because I'm maintaining *three* release notes files > just for CURRENT. Which stinks, I agree. > product should look like. I'd like to get the blessing of someone > authoritative (Nik? Jordan?) that this is at least a halfway worthy I don't expect much opposition to be honest. Most source-hackers are quite happy with any progress on the doc front so that they can spend their time hacking C (or whatever) ;-) W/ -- | / o / / _ Arnhem, The Netherlands email: wilko@freebsd.org |/|/ / / /( (_) Bulte http://www.freebsd.org http://www.nlfug.nl To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message