Date: Fri, 14 Sep 2001 08:02:38 -0500 From: Bob Van Valzah <Bob@BGPBook.Com> To: Greg Lehey <grog@lemis.com> Cc: Murray Stokely <murray@FreeBSD.org>, doc@FreeBSD.org Subject: Re: Bootstrapping Vinum Doc? Message-ID: <3BA1FFEE.7000305@BGPBook.Com> References: <3BA01768.2000902@BGPBook.Com> <20010912205708.L9233@windriver.com> <20010913152014.A783@canberra.worldwide.lemis.com>
next in thread | previous in thread | raw e-mail | index | archive | help
[-- Attachment #1 --]
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
>
[-- Attachment #2 --]
<html>
<head>
</head>
<body>
Greg & Murray, Thanks for your interest.<br>
<br>
Yes, I have heard that you're polishing the handbook. What's the deadline
for the new edition?<br>
<br>
Greg, I completely agree with your emphasis on accuracy. Incorrect doc is
much worse than none at all. I'm eager for your input.<br>
<br>
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.<br>
<br>
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?<br>
<br>
Bob<br>
<br>
Greg Lehey wrote:<br>
<blockquote type="cite" cite="mid:20010913152014.A783@canberra.worldwide.lemis.com">
<pre wrap="">On Wednesday, 12 September 2001 at 20:57:08 -0700, Murray Stokely wrote:<br></pre>
<blockquote type="cite">
<pre wrap="">On Wed, Sep 12, 2001 at 09:18:16PM -0500, Bob Van Valzah wrote:<br></pre>
<blockquote type="cite">
<pre wrap="">I'm working on an an article that describes how to get started with<br>vinum. It might make a good addition as an article, and/or perhaps pared<br>down as a new section in the handbook following Disks->ccd.<br><br>The content is fairly well along, but I still have a lot of work to do<br>on the markup.<br></pre>
</blockquote>
<pre wrap=""> Nik, Chern, and I actually spent some time this afternoon looking<br>through the Disks chapter (now the "Storage" chapter) and one of the<br>things that became immediately apparent is the huge need for a section<br>on Vinum. Is there any way that you can post what you've got so that<br>we can help out with the markup and get this into the tree ASAP? I'm<br>sure you've heard that we're polishing up the handbook for publication<br>in the very near future.<br></pre>
</blockquote>
<pre wrap=""><!----><br>I've seen a number of attempts at documenting Vinum. Some of them<br>were quite good, but they all had significant errors. If you bring<br>out a new one, please let me take a look at it first. I can't promise<br>to do it quickly, but it's very important not to release it until I<br>do. Incorrect docco never dies.<br><br>Greg<br>--<br>Finger <a class="moz-txt-link-abbreviated" href="mailto:grog@lemis.com">grog@lemis.com</a> for PGP public key<br>See complete headers for address and phone numbers<br></pre>
</blockquote>
<br>
</body>
</html>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?3BA1FFEE.7000305>
