docs: many style tweaks

tweak Table-of-Contents styles a bunch. tweak other styles, too.

Reviewed at https://rbcommons.com/s/twitter/r/1544/
Sync of https://github.com/pantsbuild/pants/commit/ffbf831800df27c7d60992aee4fb4d488acd9695