putting more stuff in the API docs
questionable, this
updated docs a bit more