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

Subject: Re: [boost] Boost.Build documentation (Was:: CMake - one more time)
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2016-04-25 07:20:28

> -----Original Message-----
> From: Boost [mailto:boost-bounces_at_[hidden]] On Behalf Of Vladimir Prus
> Sent: 23 April 2016 20:53
> To: boost_at_[hidden]
> 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
[phone]