more documentation and updates to current API