The #Python handler of #mkdocstrings now supports rendering function signature overloads. It stacks them up vertically (see screenshots).
My sponsors can now enjoy automatic cross-references in attribute signatures thanks to the latest #mkdocstrings-python Insiders version, v1.6.0.1.4.0 🙂
We just added an "autosummary" option in version 1.2.0 of #mkdocstrings-python Insiders!
See the docs: https://mkdocstrings.github.io/python/usage/configuration/members/#summary
See it in action in #Griffe's documentation: http://localhost:8000/griffe/reference/griffe/ 🚀
New #Griffe version 0.34.0 now supports Methods sections in docstrings, both for Google and Numpydoc styles! 🎉
More than that, it supports new sections for documenting classes and modules.
Thanks to this, we will be able to implement auto-summaries for the 4 categories of objects (attributes, functions/methods, classes and modules) in #mkdocstrings' Python handler 😎
Also, Griffe now documents the Numpydoc style: https://mkdocstrings.github.io/griffe/docstrings/#numpydoc-style
After a long time, since the new Python handler was released, class inheritance support is back into #mkdocstrings 🌲
v1.2.0 for mkdocstrings-python, v1.2.0.1.1.2 for insiders.
I want to thank my amazing sponsors for allowing this to happen. This would not be possible without you 🙇
Thank you so much! ❤️
#Griffe docs now show inherited members: https://mkdocstrings.github.io/griffe/reference/griffe/dataclasses/
I'll have to work on adding proper Jinja blocks into #mkdocstrings-python's templates before being able to release version 1.0.0 of this extension.
I've completely reworked the extension system of #Griffe, to make it easier to use.
To test it before releasing anything, I prototyped a #Pydantic extension. Here's a preview of the result in #mkdocstrings 🤩
#Griffe #pydantic #mkdocstrings
#mkdocstrings users will soon be able to documented inherited members again!
When we went from pytkdocs (dynamic only) to Griffe (static and/or dynamic analysis), we lost inheritance support, because it had to be supported by static analysis too.
I finally had some time to work on it: https://github.com/mkdocstrings/griffe/pull/170 🎉
Expect a mkdocstrings-python release soon 😄