further changes to api doc