-----Original Message----- From: Boost [mailto:boost-bounces@lists.boost.org] On Behalf Of Vladimir Prus Sent: 23 April 2016 20:53 To: boost@lists.boost.org Subject: [boost] Boost.Build documentation (Was:: CMake - one more time)
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.
I might find time to make some concrete suggestions. (As everyone knows, there are always more exciting projects ;-)
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.
That would be a real help to wannabe authors. Over times, I looked at the jamfiles in lots of libraries. Everyone seems to do it differently, often for reasons that are not clear to me. A clear recommendation (preferably with some comments on what and why) would reduce entropy here. Thanks Paul --- Paul A. Bristow Prizet Farmhouse Kendal UK LA8 8AB +44 (0) 1539 561830