Docs cleanup & MacOS clarifications

[nsjames]

This PR cleans up some duplicated information, adds a table of contents for easy browsing, and clarifies the steps required to install on MacOS.