Wannabe contributor frustrations

[Atila Neves via Digitalmars-d]

On Thursday, 11 February 2016 at 04:37:39 UTC, Jonathan M Davis 
wrote:
> On Thursday, 11 February 2016 at 02:07:54 UTC, Etienne wrote:
>> On Wednesday, 10 February 2016 at 23:30:03 UTC, Márcio Martins 
>> wrote:
>>> [...]
>>
>> It took me way more than 2 hours to grasp how this build 
>> process works. It wasn't until I had read through the whole 
>> source code actually.
>
> It's also a pain to edit. It's been suggested several times 
> that we change the build system (e.g. to use 
> https://github.com/atilaneves/reggae), but IIRC, Walter and 
> Andrei have generally been opposed to the idea of changing it. 
> It's one of those things that frequent contributors have more 
> or less sorted out and don't usually worry about much anymore 
> (aside perhaps from the rare occasions when they need to edit 
> the makefiles), whereas it definitely tends to bite folks who 
> aren't familiar with it. And building the documentation is that 
> much worse.

Tell me about it. I'm still not 100% sure what I need to do to 
build the docs and only managed the 1st time at DConf 2015 with 
Robert next to me telling me what to do.

Atila