start on improving the api doc contents