adding some docs about the api