From owner-freebsd-doc Fri Sep 14 6: 3: 7 2001 Delivered-To: freebsd-doc@freebsd.org Received: from smtp.whitebarn.com (Spin.whitebarn.com [216.0.13.113]) by hub.freebsd.org (Postfix) with ESMTP id 1596A37B40D; Fri, 14 Sep 2001 06:03:03 -0700 (PDT) Received: from BGPBook.Com (Relent.Bob.whitebarn.com [216.0.13.50]) by smtp.whitebarn.com (8.9.3/8.9.3) with ESMTP id IAA58506; Fri, 14 Sep 2001 08:02:38 -0500 (CDT) (envelope-from Bob@BGPBook.Com) Message-ID: <3BA1FFEE.7000305@BGPBook.Com> Date: Fri, 14 Sep 2001 08:02:38 -0500 From: Bob Van Valzah User-Agent: Mozilla/5.0 (X11; U; Linux i386; en-US; rv:0.9.2) Gecko/20010726 Netscape6/6.1 X-Accept-Language: en-us MIME-Version: 1.0 To: Greg Lehey Cc: Murray Stokely , doc@FreeBSD.org Subject: Re: Bootstrapping Vinum Doc? References: <3BA01768.2000902@BGPBook.Com> <20010912205708.L9233@windriver.com> <20010913152014.A783@canberra.worldwide.lemis.com> Content-Type: multipart/alternative; boundary="------------020301060300040408000202" Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org --------------020301060300040408000202 Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit Greg & Murray, Thanks for your interest. Yes, I have heard that you're polishing the handbook. What's the deadline for the new edition? Greg, I completely agree with your emphasis on accuracy. Incorrect doc is much worse than none at all. I'm eager for your input. I think I have to add some of the and markup myself before your review. Otherwise, you'd have to review the raw SGML. I hope to get that part of the markup done and touch up a few figures in the next day or two. That'd get you a review copy this weekend or Monday at the latest. How's that? Bob Greg Lehey wrote: >On Wednesday, 12 September 2001 at 20:57:08 -0700, Murray Stokely wrote: > >>On Wed, Sep 12, 2001 at 09:18:16PM -0500, Bob Van Valzah wrote: >> >>>I'm working on an an article that describes how to get started with >>>vinum. It might make a good addition as an article, and/or perhaps pared >>>down as a new section in the handbook following Disks->ccd. >>> >>>The content is fairly well along, but I still have a lot of work to do >>>on the markup. >>> >> Nik, Chern, and I actually spent some time this afternoon looking >>through the Disks chapter (now the "Storage" chapter) and one of the >>things that became immediately apparent is the huge need for a section >>on Vinum. Is there any way that you can post what you've got so that >>we can help out with the markup and get this into the tree ASAP? I'm >>sure you've heard that we're polishing up the handbook for publication >>in the very near future. >> > >I've seen a number of attempts at documenting Vinum. Some of them >were quite good, but they all had significant errors. If you bring >out a new one, please let me take a look at it first. I can't promise >to do it quickly, but it's very important not to release it until I >do. Incorrect docco never dies. > >Greg >-- >Finger grog@lemis.com for PGP public key >See complete headers for address and phone numbers > --------------020301060300040408000202 Content-Type: text/html; charset=us-ascii Content-Transfer-Encoding: 7bit Greg & Murray, Thanks for your interest.

Yes, I have heard that you're polishing the handbook. What's the deadline for the new edition?

Greg, I completely agree with your emphasis on accuracy. Incorrect doc is much worse than none at all. I'm eager for your input.

I think I have to add some of the <procedure> and <programlisting> markup myself before your review. Otherwise, you'd have to review the raw SGML.

I hope to get that part of the markup done and touch up a few figures in the next day or two. That'd get you a review copy this weekend or Monday at the latest. How's that?

    Bob

Greg Lehey wrote:
On Wednesday, 12 September 2001 at 20:57:08 -0700, Murray Stokely wrote:
On Wed, Sep 12, 2001 at 09:18:16PM -0500, Bob Van Valzah wrote:
I'm working on an an article that describes how to get started with
vinum. It might make a good addition as an article, and/or perhaps pared
down as a new section in the handbook following Disks->ccd.

The content is fairly well along, but I still have a lot of work to do
on the markup.
  Nik, Chern, and I actually spent some time this afternoon looking
through the Disks chapter (now the "Storage" chapter) and one of the
things that became immediately apparent is the huge need for a section
on Vinum.  Is there any way that you can post what you've got so that
we can help out with the markup and get this into the tree ASAP?  I'm
sure you've heard that we're polishing up the handbook for publication
in the very near future.

I've seen a number of attempts at documenting Vinum.  Some of them
were quite good, but they all had significant errors.  If you bring
out a new one, please let me take a look at it first.  I can't promise
to do it quickly, but it's very important not to release it until I
do.  Incorrect docco never dies.

Greg
--
Finger grog@lemis.com for PGP public key
See complete headers for address and phone numbers

--------------020301060300040408000202-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message