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