add TOCs to API pages

doc is lengthy, so provide list of links to each API method. Also, demote some headings