added some docs for the api... more to come.