Make README more user-friendly

Add table of contents and some minor formatting changes to (hopefully) make the README more user-friendly
That paragraph should be de-indented (dedented?) if we use triple quotes.