- first finalised version of API doc
 - minor API changes