more on the api doc