Various recomended changes to the out of source build docs

I've also left some comments on the branch
1 file changed