21 ms·
Sigh. Markdown is "good enough". If it helps writing documentation, it is a good tool. What I struggle with is documentations that are incomplete (e.g. miss c
by stared 7y ago
Sigh. Markdown is "good enough". If it helps writing documentation, it is a good tool.
What I struggle with is documentations that are incomplete (e.g. miss crucial, "obvious" installing steps), out-of-date, or incomprehensible. Often external contributors help (especially newbies), as they look at your project with a fresh eye, taking nothing for granted.
If for a given project .rst is better than .md, cool. And if you generate HTML from it, end-users won't care what was your base format.