add docstrings from spec