Re:Markdown, Asciidoc, or reStructuredText – a tale of docs-...
by packetlost on Friday November 04, 2022 @02:59PM
(#33471941)
I'm primarily a Python dev. I *hate* RST. I despise that it's really the only viable choice for docstrings in Python and wish for something rustdoc-like to be ported to Python
[ Parent
| on HN ]
Re:Markdown, Asciidoc, or reStructuredText – a tale of docs-...
by BiteCode_dev on Friday November 04, 2022 @03:11PM
(#33472156)
Same.
Good news though, the jupyter devs created myst (https://myst-parser.readthedocs.io/en/latest/syntax/syntax.h...), a superset of markdown that has almost all the features of rst, and can embed rst when it falls short.
And there is a plugin to use it with sphinx. It can even reside in a project that started with rst files, both format can coexist.
With this and sphinx-autoreload, writing doc is so much better.