Rejiggered README

Incorporating all of what was on wiki main page, plus any other noticed
missing classes. Serves as a table of contents linking to other docs.
Examples moved to docs relevant to those examples.
Merge pull request #194 from jrochkind/readme

Rejiggered README