adds "some" comments to the API