pull public api docs into actual docs, update readme