API doc improvements

This pull request adds several additional api doc improvements and fixes.