More docs updates

* Instance attributes switched from table format to sphinx python
  domain formatting

* Update README with new sections in TOC

* Add notes about the results returned from listdir

* Fix formatting on a seealso in the getting started section