start documenting the API