doc: Explain light-handed markup preference a bit better
authorDaniel Vetter <daniel.vetter@ffwll.ch>
Thu, 2 Mar 2017 15:16:33 +0000 (16:16 +0100)
committerJonathan Corbet <corbet@lwn.net>
Thu, 9 Mar 2017 09:44:44 +0000 (02:44 -0700)
commitc3c53600f62b5fa92acf3a7f5eb71bacb25f6b01
tree54dd60d1a770929617fc8979d10dbe717a21eaff
parent54f5d13b708a64177d4437a2b23fb05035f90716
doc: Explain light-handed markup preference a bit better

We're still pretty far away from anything like a consensus, but
there's clearly a lot of people who prefer an as-light as possible
approach to converting existing .txt files to .rst. Make sure this is
properly taken into account and clear.

Motivated by discussions with Peter and Christoph and others.

Cc: Christoph Hellwig <hch@infradead.org>
Cc: Peter Zijlstra <peterz@infradead.org>
Cc: Jani Nikula <jani.nikula@linux.intel.com>
Cc: Mauro Carvalho Chehab <mchehab@s-opensource.com>
Signed-off-by: Daniel Vetter <daniel.vetter@intel.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Documentation/doc-guide/sphinx.rst