Full pass at inline API Docs

closes #2622, ref #2125
Merge pull request #2867 from ErisDS/api-docs

Full pass at inline API Docs