* Some of our chapters are pretty long and this should make it much
easier for a user to find what they're looking for and jumping
to it. It's easier to read the section toc at the top of the
chapter, than it is to read it in the sidebar.
* overhauls the docs so they're (hopefully) clearer on the git
workflow
* adds text about putting things in bugfix branches, documenting
your work, and using the issue tracker
* adds a contrived example that uses aliens
