updates to api doc