docs to reflect some api changes