Update readme with better how to deploy
[typo]
replace chars in headings
remove docs from source
update doc generation