On 4/23/16 12:52 PM, Vladimir Prus wrote:
On 4/22/2016 4:20 PM, Paul A. Bristow wrote:
I'd like to see a complete rewrite of documentation. Paradoxically, I want it written by someone who is *not* an author or expert. (Obviously it will have to be edited by several people who *are* experts).
There sadly does not appears to line of people willing to help with documentation (in any open-source project I ever worked with). Boris was the only one recently, having authored all of
http://www.boost.org/build/tutorial.html
It would seem the only practical approach at this point would be if each interested party spend send me a list of things they want changed in docs, or spend some time over Skype call to literally walk through documentation as if for the first time, and point out issues.
For future library authors, a template dummy project with all the folders and files assembled to copy and modify for their library would mean that the learning curve is less steep - at present, it's an overhang!
That's a good idea, and will be easy to do for me.
One idea might be worth experimenting with would be user update-able documentation like php has. Robert Ramey