update documentation to match implementation