- first finalised version of API doc