need to document how the api works so others can use it w/ less pain
need to document how the api works so others can use it w/ less pain