Re: [boost] [serialization] Doc problems

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