Chris Sewell

> options are [google](https://google.github.io/styleguide/pyguide.html#38-comments-and-docstrings), [numpy](https://numpydoc.readthedocs.io/en/latest/format.html#docstring-standard), and [pep257](https://peps.python.org/pep-0257/) the sphinx codebase already uses the standard sphinx implementation for docstrings, not google or numpy, therefore we should only use `pep257`

> I had the habit to ask people to either not type or type everything in the function. However, with the limitations by mypy and IDEs, I feel we need...

> A better mechanism (though a much larger architectural change) might be for plugins to somehow subclass `Config` and add their own properties that way > So, a plugin would...

> From what I understood, extensions would write a dataclass as their "additional configuration" and you would merge them together right, producing a "single" configuration class that inherits from those...

> in this case i'm reading from the environment rather than config sphinx-needs also does a similar thing, to return extension specific state from the environment 😄 at the end...

All good @asmeurer 😄 ?

> I tried this but I got an exception: you haven't updated your mdit-py-plugins version

> I have the latest version from conda. Is there a dev version I need to use? yeh it was only released on pypi today, so this has only just...

> It is giving the line for the beginning of the paragraph instead of the line with the label. ah well, if you haven't noticed this the same for every...

I definitely get "good" warnings now, if I add some test examples to the top of `docs/index.md`