[boost] Boost.Build documentation (Was:: CMake - one more time)

Subject: [boost] Boost.Build documentation (Was:: CMake - one more time)
From: Vladimir Prus (vladimir.prus_at_[hidden])
Date: 2016-04-23 15:52:40

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.

-- 
Vladimir Prus
http://vladimirprus.com