Re: [PATCH v3 05/21] Documentation/applying-patches.txt: convert it to ReST markup

From: Jonathan Corbet
Date: Fri Sep 16 2016 - 13:10:39 EST


On Wed, 14 Sep 2016 08:06:34 -0300
Mauro Carvalho Chehab <mchehab@xxxxxxxxxxxxxxxx> wrote:

> - use the correct markup to identify each section;
>
> - Add some blank lines for Sphinx to properly interpret
> the markups;
>
> - Remove a blank space on some paragraphs;
>
> - Fix the verbatim and bold markups;
>
> - Cleanup the remaining errors to make Sphinx happy.

So I certainly don't have a problem with the changes made to this file, but
there is some discomfort at a higher level:

> +Last update:
> + 2006-01-05

I have to wonder what the value of a document saying how to FTP the patch
and move up to 2.6.13 is in 2016.

Who knows, there might still be value in a discussion of using the patch
tool. But I think we should seriously consider making a "historical"
section for documents that are nearing or past their expiration dates.

jon