[WIP] document all the API methods