Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

I don't think there is anything in RST that encourages deep nesting level or verbose markup, on the contrary with default roles it can be more compact than Markdown. If you look at good documentation examples, like The Python Standard Library documentation (https://docs.python.org/3/library/index.html), nesting is very limited and the documentation source is very clean and readable.


I agree with everything you say. All I'm saying is that in practice, the rST docs I saw, and the issues that came up around theming rST docs led me to believe that the flexibility of rST was its biggest problem (and strength).

Markdown doesn't have that problem because you can't do much with Markdown.


I think you are both right. This discussion reminds me of the classic C vs. C++ discussion.

> http://thread.gmane.org/gmane.comp.version-control.git/57643...

Ultimately, I lean towards rST since you can combat complexity with "good practices" (as a Python guy this is akin to being Pythonic) but the opposite is not true for less complex implementations.

But there are merits to both approaches.


It's not about encouraging complex markup, it's about discouraging or just fully disallowing it.




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: