Open
Description
I think it would be nice in the documentation here, to have a brief section about extending sphinx:
- How to do some "quick and dirty" things in your
conf.py
with thedef setup(app: Sphinx)
"hook" (e.g. as I have very much done inLine 209 in 01c7565
- Then possibly about how you might want to later extract this into a "fully fledged" extension package
Obviously we don't want to rehash, what is already in sphinx: https://www.sphinx-doc.org/en/master/development/index.html, but
- It maybe does still leave a little to be desired, in introducing the subject to beginners (New Sphinx tutorial for beginners sphinx-doc/sphinx#9165)
- There is some "RST first" wording in there
@choldgraf I know you have written a few things about this in your blog (https://chrisholdgraf.com/blog/2023/social-directive/)
I wonder if you would be willing to add a little something here 😬 ?