Discussion about this post

User's avatar
Neural Foundry's avatar

Congrats on the solid year! The Sphinx custom theme work particularly caught my eye since I've spent way too many hours fighting with docutils rendering quirks. What's intreresting is how documentation tooling is becoming almost as fragmented as frontend frameworks these days. At a previos job, we migrated from reStructuredText to Markdown for developer experience but then realized we lost a bunch of semantic structure. The tradeoff between writer ergonomics and reader precision keeps showing up everywhere.

No posts

Ready for more?