Add TOC, typo fixes

Table of Contents generated with DocToc, http://doctoc.herokuapp.com/. I've removed level-3 headings, which were generated for most methods because their description starts with '###'. Might be worth considering making those plain text.