remove itemize in @return; add some markup; add links to neotoma functions; switch to singular function names