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