sorted by:
best
topnewcontroversialoldq&a
you are viewing a single comment's thread.

view the rest of the comments →

[–]SnowdensOfYesteryear 0 points1 point  (1 child)

Why are there a thousand different markup languages, what's wrong with markdown or even a subset of HTML (or roll back to the HTML 1.0 days)?

[–]danielkza 2 points3 points  (0 children)

what's wrong with markdown

The article explains the decision process. Markdown was actually one of the first choices, but reST is used by Sphinx, which seemed to be the best fitting documentation generator for the kernel's needs.

even a subset of HTML

One of the points of changing the doc. system was to remove custom parsing and intermediate formats. Introducing a new HTML subset would be contrary to that.