News for hackers. Stuff that matters.
Re:The Problem with Linux Kernel Documentation, and How We'r... by Poiesis on Wednesday September 28, 2016 @05:11PM (#12601400)
Mind explaining why? I like Markdown but would like to know what ReST does better.
Re:The Problem with Linux Kernel Documentation, and How We'r... by has2k1 on Wednesday September 28, 2016 @05:53PM (#12601647)
ReST can be better extended without creating a variant of the markup language [1]. Extension support is first class [2], and it is by that means that a good number of the core features are implemented.

[1] For example, github flavour, stackoverflow flavour, reddit flavour, ...

[2] Roles and directives.

Re:The Problem with Linux Kernel Documentation, and How We'r... by catdog on Thursday September 29, 2016 @08:07AM (#12604623)
One large difference is that Markdown exclusively targets HTML as an output format where ReST tries to be format agnostic. If you only ever target HTML this might ease some things but not if you want html, man pages, pdfs, plain text, …
Re:The Problem with Linux Kernel Documentation, and How We'r... by eliben on Thursday September 29, 2016 @12:13PM (#12606429)
ReST is a whole multi-document system, as opposed to MD which is just the formatting (at least before you mix in the dozens of mutually incompatible extensions). ReST is a superset.