update docs to reflect API change