[wip] Doc improvements

This pull request adds several additional apidoc improvements and fixes. I will be adding a few more and leave a note here when this is ready for review.