Docstring Standardization
=========================

Style
-----

- Preferred style: `Google Python Style Guide (Docstrings) <https://google.github.io/styleguide/pyguide.html#38-comments-and-docstrings>`_.
- Rendered via Sphinx with ``sphinx.ext.napoleon`` (Google-style parsing enabled).

Guidelines
----------

- Include a short summary line in the imperative mood.
- Provide sections as needed: ``Args``, ``Returns``, ``Yields``, ``Raises``, ``Notes``, ``Examples``.
- Use explicit types and shapes when helpful; prefer concrete meanings over abbreviations.
- Keep examples runnable when possible.


