finish up second pass through docs nav, headings, organization, naming, etc (another run through at #9710)
