adding documentation for the api is important.
pretty much done in the wiki, but not completely up to date