cleanup
doc link updates
reworked docs to use the new toc.yml approach
tweaks to keep the PDF from clipping on the right