Post #1654678
2026-04-23 06:41 UTC
@iamkonstantin Personally I have worked with Sphinx quite a bit and I've decided that it's really only a good fit if the project you're building the doc site for can be almost entirely hands-off. If your main concern is auto-generating coverage of the codebase, it works. If you have a lot of tutorial content, it's a pain.
i.e., Sphinx is arduous to customize and not well-suited for doc sets that need structure or components beyond the as-is source tree.
Replies (1)
-
@iamkonstantin@mastodon.social 2026-04-23 06:45
@n8@mastodon.social Thanks for the tip! Indeed it's a bit of a mix - there are tutorials and KB posts but also a lot of usage docs + examples. I will try it out. I see now that Sphinx can work with more than just markdown which is cool