[Scons-dev] User-guide generation

[Dirk Bächle]

Hi William,

On 21.08.2016 17:53, William Blevins wrote:
>
> [...]
>
> I would argue that "the normal user" never runs the document building scripts, so I don't see how that applies.

it applies because the building scripts, and the Doc toolchain, around it is especially designed and setup such that "the normal 
user" can run them without having to install too many additional dependencies. He doesn't get an updated example text or a refreshed 
Builder description, but if he simply edited or changed a paragraph in one of the chapters he certainly shouldn't mind.

>
> As I said, I haven't been in this community long, so I don't know the history of SCons (not really). How and why were some decisions
> made? As I work on the code, those questions aren't irrelevant. Text has this way of removing body language. I hope I don't sound
> combative because that's not my intention. I just like being frank, and I like questions. I have a weird mix of software development
> and tester experience, so questions just come with the territory. I also tend to use emails like others use instant messaging. I
> think it comes with the age demographic. This tends to annoy people. Sorry :)
>

That's okay.

But what is the actual remaining problem that you would like to tackle? The docs rebuild when one of the chapter *.xml files change, 
which is what I'd call "correct behaviour".

Regards,

Dirk