On Mon, Sep 24, 2018 at 08:44:07PM +0200, Markus Armbruster wrote:
[...]
> Remind me, why would rST be an improvement?
Relatively easy on the eye, more maintainable, active community around
the Sphinx tooling / extensions, not extremely arcane syntax (besides
some weird quirks), etc.
Take a look at its output (from a random page out of kernel
documentation):
https://www.kernel.org/doc/html/v4.11/driver-api/80211/mac80211-advanced.html
LWN did some analysis[1][2] on how the Linux kernel arrived at rST (with
Sphinx).
An example rendering of a document from the QEMU Git tree:
https://kashyapc.fedorapeople.org/QEMU-Docs/_build/html/docs/interop/live-block-operations.html
Not sure if that's improvement in your judgement, though. :-)
[...]
[1] https://lwn.net/Articles/692704/
[2] https://lwn.net/Articles/692705/
--
/kashyap
