News for hackers. Stuff that matters.
Re:Don’t Use Markdown for Documentation by ajford on Tuesday March 15, 2016 @08:53PM (#11294193)
True. But that's not always all that's needed. If I decide to flesh out an API section, it would be better to put the work in and use autodoc (which of course means I have to go make sure my docstrings are up to date). Build a TOC. A lot of things in RST are not in Markdown (the whole point of this article), and would have to be added to really take advantage of RST.

There are no comments on this comment yet.