Toc for docs pages 

see _config.yml and try swapping out redcarpet with kramdown and see if you like the results.  The toc links can be configured to generate friendly names instead of what we currently have : toc_1, toc_2, etc. 

It appears the the previous devs on this had this in mind because their hand written TOC code works perfectly if we switch to kramdown.  

Lots of options.  talk to me.