Common makefile (gasp) stuff

[Paul O'Neil via Digitalmars-d]

On 01/13/2015 09:35 PM, Andrei Alexandrescu wrote:
<snip>
>> 1) These interdependencies are currently expressed by hard-coded
>> filesystem paths, which presumes a specific directory layout for
>> checking out dmd, dlang.org, phobos, druntime. This means the build will
>> break if somebody doesn't know the correct directory structure to use
>> when checking out these repos.
> 
> Yah, that should be in a wiki. I keep on thinking about producing a
> 10-minutes video "Your First Contribution to D" in which I explain step
> by step how to get a pull request in starting from a scratch.
> 
> We also have tools/update.sh which should probably be more prominently
> advertised.
> 
<snip>

This shouldn't go (only) in the wiki.  It should be in the README of
every repository.  And if not in the README, then the CONTRIBUTING file.
 A minimal list of "clone these things, run make in these directories"
is fine here with a reference to the wiki for more details.

I put off some documentation updates a few months ago because it wasn't
worth the investment yet to figure out how to build the website.  The
wiki pages appeared to be about building the compiler, which I didn't
realize I should be interested in.  This barrier is too high.

-- 
Paul O'Neil
Github / IRC: todayman