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.