editing structure of docs

To reflect this:
<https://etherpad.mozilla.org/zKDtgfoUuD>

I also did a first pass at making sure all links within the documentation were accurate.  (There's nothing visibly inaccurate, but I did not click on every single ref/link.)