improvements for introductory docs

* Enriched docs with some getting started notes
* Add unused doc/ directory to index
* Updates in README
* Formatting improvements