Hacker News new | past | comments | ask | show | jobs | submit login

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.




Consider applying for YC's W25 batch! Applications are open till Nov 12.

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

Search: