[doc][s]: add better instructions to README for setting up locally.
[#425,doc][s]: copy doc folder back to master from gh-pages - fixes #425.