Better Table of Contents

[rcherny]

I think we may need a better Table of Contents system. Thoughts include:

• the sections are big enough that the headers to a lower level might be useful
• the current side TOC obviously won't suffice
• a scrollspy type UI (Track the menu location against the scroll #148) or
• section by section being 'sticky' (e.g. CSS stays at top in CSS section) might be useful

[rcherny]

Our current TOC is generated by JavaScript when the page is loaded. However, we could probably generate the TOC from the Markdown during the build with something like:

https://github.com/jonschlinkert/markdown-toc

[roblarsen]

Serving static HTML FTW.

[rcherny]

Yeah. Never liked that approach but our build wasn't smart enough. Now it can be.