Open melissawm opened 1 month ago
May be interesting to explore https://www.sphinx-doc.org/en/master/usage/extensions/autodoc.html#event-autodoc-process-signature
Ideally, there wouldn't be the redundant repetition of the title and then again the object documentation. I've looked into removing the title altogether in the past. I think the tricky bit was to get the object documentation to appear in the sphinx TOC. But I think there was some work on that in sphinx or at least a feature request?
Is this what you mean @lagru ?
After discussion with @lagru this is a second approach:
Note the absence of page title and reorganization of signature elements.
Ideally, this should be an option at the theme level.
Current style is to display using non-monospace font:![Captura de imagem_20240603_151447](https://github.com/scientific-python/summit-2024/assets/3949932/0175d229-f2e1-4f7e-b473-df8b68de49af)
Suggestion:![Captura de imagem_20240603_151621](https://github.com/scientific-python/summit-2024/assets/3949932/fb8e9750-a567-4477-8c0f-4cc2030a055a)