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.
> 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
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.
-- Shunsuke Sogame
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk