improve protocol docstrings