refs section has complete api coverage (finally)

- plus additional subsection refactoring
nicer group headings on ref pages