Re: [boost] Some notes on Egg

From: shunsuke (pstade.mb_at_[hidden])
Date: 2008-04-19 05:25:56

John Phillips wrote:
>    The other problem I have with the documentation is that the author 
> seems to know what he is talking about well enough that he doesn't 
> realize that it is not complete enough for many potential readers.
<snip/>
>    My second suggestion is to think a lot about how to reorganize the 
> documentation with a new user of the library in mind. If someone comes 
> to the library without knowing what you are doing, how can you show them 
> each of the advantages of the library, preferably one at a time? How can 
> you build the ddocs to draw them through that process and to make it 
> obvious what parts of the library will help solve what problems for the 
> user?

I understand the documentation was the problem.
Anyway if I'm expected to write a substantial tutorial for functional
programming in C++, it is rather difficult for me.
Now I'm going to be convinced of my error to propose a generic library
which is more than I can do.

Regards,

-- 
Shunsuke Sogame