reStructuredText and the curious case of how headers are implemented
While I use ReStructuredText, and its companion platform Sphinx-Doc a lot, that doesn’t mean that I believe they’re the best combination for technical writing and documentation.
While I use ReStructuredText, and its companion platform Sphinx-Doc a lot, that doesn’t mean that I believe they’re the best combination for technical writing and documentation.
Do you love the variety of formats that you can publish and subscribe to in this veritable golden-age of computing we’re enjoying? Same here. Whether it’s JSON, XML, RSS, Atom, CSV or even Excel format, there’s just so much choice.
The challenging thing is that though there’s so much choice of format, there are also so many demands to use them - ALL. So what do you do when your boss, client, friend, family-member (whom you’re the technical support person for) requests this for their blog or site?