expanded class docstrings