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.
[ Parent
| on HN ]
There are no comments on this comment yet.