Clean up the repo README

[prestoncabe]

ideas:

• make a table of contents with links at the top.
• link to longer documentation (like dev setup) instead of inlining it.
• look for overlap with the doc folder and resolve any discrepancies too.