On Tue, 23 Apr 2019 15:01:32 +0200 Peter Zijlstra <peterz@xxxxxxxxxxxxx> wrote: > But yes, I have 0 motivation to learn or abide by rst. It simply doesn't > give me anything in return. There is no upside, only worse text files :/ So I believe it gives even you one thing in return: documentation that is more accessible for both readers and authors. More readable docs should lead to more educated developers who understand the code better. More writable docs will bring more people in to help to improve them. The former effect has been reported in the GPU community, where they say that the quality of submissions has improved along with the docs. The latter can be observed in the increased number of people working on the docs overall, something that Linus noted in the 5.1-rc1 announcement. Hopefully that's worth something :) Thanks, jon
