updated docs and comments, with instructions that work fora local bu…

[paddymul]

These extra README instructions work for me to run a local build. They might not be the best way of doing it, but it's a start