News for hackers. Stuff that matters.

A comment on The Problem with Linux Kernel Documentation, and How We're Fixing It. Parent comment

Re:The Problem with Linux Kernel Documentation, and How We'r... by grive on Wednesday September 28, 2016 @04:10PM (#12600896)
3. Pick a language that already supports it and is stable, standardized, without having to whip out some specialized version just for your codebase.
[ Parent | on HN ]
Re:The Problem with Linux Kernel Documentation, and How We'r... by dend on Wednesday September 28, 2016 @04:28PM (#12601077)
Not like you have to do anything to get it to work OOB, but your mileage may vary. One of the benefits of Markdown is that it's easily understood by people new to the doc space. RST is slightly more complex and has more rules added in.
[ Parent | on HN ]