some doc updates, removals
added theory posts
added examples
re-titled
Merge branch 'examples' into cloudant
merged src/index