3 ms·
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 p
by packetlost 4y ago
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
- BiteCode_dev 4y agoSame. Good news though, the jupyter devs created myst (https://myst-parser.readthedocs.io/en/latest/syntax/syntax.html#syntax-core 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.