A private answer to Dave has been bounced

From: Andrey Melnikov (melnikov_at_[hidden])
Date: 2005-10-11 01:58:15

So I repost it here.

-------- Original Message --------
Subject: Mail delivery failed: returning message to sender
Date: Fri, 07 Oct 2005 19:21:16 +0300
From: Mail Delivery System <mailer-daemon_at_[hidden]>
To: melnikov_at_[hidden]

This message was created automatically by mail delivery software.

A message that you sent could not be delivered to one or more of its
recipients. This is a permanent error. The following address(es) failed:

dave_at_[hidden]
SMTP error from remote mailer after RCPT 
TO:<dave_at_[hidden]>:
host boost-consulting.com [64.39.18.17]: 591 your host 
[217.144.68.1] is blacklisted by bl.spamcop.net.

------ This is a copy of the message, including all the headers. ------

Return-path: <melnikov_at_[hidden]>
Received: from zone3000.kharkov.ua ([217.144.68.98] helo=[10.1.1.177])
by aviti.net with esmtp (Exim 4.30; FreeBSD)
id 1ENuxp-000IQi-A1
for dave_at_[hidden]; Fri, 07 Oct 2005 19:20:53 +0300
Message-ID: <4346A044.5090209_at_[hidden]>
Date: Fri, 07 Oct 2005 19:20:20 +0300
From: Andrey Melnikov <melnikov_at_[hidden]>
Organization: SimplexSoft
User-Agent: Mozilla Thunderbird 1.0.6 (Windows/20050716)
X-Accept-Language: en-us, en
MIME-Version: 1.0
To: David Abrahams <dave_at_[hidden]>
Subject: Re: BBv2 doc rewrite
References: <ud5mhtmln.fsf_at_[hidden]>
In-Reply-To: <ud5mhtmln.fsf_at_[hidden]>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit

David Abrahams wrote:
> Hi Andrey,
> 
> I am convinced we can't get the right documentation just by pushing
> around bits of the current ones. I have committed to Vladimir that I
> would rewrite the BBv2 docs from scratch (incorporating bits of the
> current docs as necessary), on two conditions:
> 
> 1. I get your partnership
> 
> 2. He explains everything to us so that we can do a good job
> 
> So, what do you say?
> 

I'm glad to hear from you offlist. As you can see, I didn't post to the
list for the last 2 weeks. I was busy with my daily job. Fortunately,
this period of tight deadlines finished yesterday, so your message
arrived in time.

So I totally missed the whole discussion regarding the documentation,
and didn't review the msvc.jam patches by Alexey Pakhunov.

Now I'm free and ready to help you. Unfortunately, I'm a lazy person
that cannot work without external push, so you'll have to be the pusher
:) I'd like to have a schedule and deadlines. We'll establish them
together and will both try to follow them.

I agree that we cannot get the right documentation by patching the
existing one. So, as the first step, I'd like to create an outline of
the new documentation layout, and document the rationale for it. We will
use this rationale document as a guide for further writings.

Regarding the point 2, I don't think that it's possible to learn BBv2
completely in a short term. I think that even without this kind of
knowledge we are still able to create much better introductory
documentation than we have now.

Personally, I hate such approach but I don't see any alternative ways to
go for now. Let's focus on the basic documentation first.

Andrey

P.S. You can forward my reply to the list if you want.