work in progress
updated documentation and incorporated latest groc-api changes