From: Matthias Troyer (troyer_at_[hidden])
Date: 2005-09-09 01:31:52
On Sep 9, 2005, at 3:04 AM, Robert Ramey wrote:
> David Abrahams wrote:
>> IMO you ought to recognize that and not be so quick to
>> argue with someone who is reporting that the docs are hard to use and
>> suggesting ways to improve them, especially when that person has been
>> through that cycle many times with his own users and learnt from his
>> mistakes.
>>
>
> lol - I've made lots of changes in documentation and in code in
> response to
> user reports that something doesn't make sense or is hard to
> understand.
> I've acknowledged that I struggled to find a good way to make such a
> document. I've conceded a number of specific points on which I
> decided I
> was wrong and agreed to make changes. Somethings I don't agree
> with and
> I've labored to explain my reasons. Other points require more
> consideration
> on my part. And some points we'll just have to agree to disagree.
> Sorry.
FWIW, I've tried to code a few archive types over the past year and
reading the documentation alone was not sufficient. I had to look at
the source codes of your archives to see how to actually write an
archive. This should not be necessary.
Matthias