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

Subject: Re: [boost] Boost.Build documentation (Was:: CMake - one more time)
From: Robert Ramey (ramey_at_[hidden])
Date: 2016-04-23 18:05:28

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