update documentation to reflect current usage