reStructuredText: how not to do it
July 9, 2020•126 words
reStructuredText manages:
- to be very painful to write compared to, for instance, Markdown (why double backquotes around code? I mean, seriously, what purpose does that serve?);
- to be complicated enough that you often need to look things up, and end up using it in inconsistent ways ('what's the right syntax for a reference to a method in another class again?, oh, I'll just use ``...``: it's wrong but it will do');
- to not be expressive enough that it becomes second nature in the way (La)TeX does for mathematics – TeX was written by someone who typed a lot of maths, reStructuredText seems to have been designed by a committee some of whose members may have been camels.
There is nothing good about it.