cleaned up doc intro and README
Merge branch 'master' into doc-build
new doc-build after master merge