updates readme and docblocks for response refactor