updated guide and apidocs to correspond to changes in api