3 ms·
I find RST simply miserable to write and even worse to read. All of your points are valid regarding it being an actual spec, but reading and writing it in the r
by isbjorn16 6y ago
I find RST simply miserable to write and even worse to read. All of your points are valid regarding it being an actual spec, but reading and writing it in the raw vexes me to no end.
I still use it for my module documentation, but I still use Jekyll for my personal sites instead of something like Sphinx (which is another element of hell for me - the errors when your RST is wrong are worse than useless;
> "You have an error somewhere between _here_ and _here_"
"You just pointed to everything"
> "Yes I did"
- Tomte 6y agoAsciiDoc(tor) is worth a look, it's better specified than Markdown (and has much features), but doesn't look as ugly as restructuredText. It's quite niche, though. And if you don't want the Ruby dependency, AsciiDoctorJ is very usable.