Re: [PATCH v2 56/79] docs: Documentation/*.txt: rename all ReST files to *.rst

Jonathan Corbet
2019-04-23T20:34:38Z

On Tue, 23 Apr 2019 17:19:44 -0300
Mauro Carvalho Chehab <mchehab+samsung-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org> wrote:

> Anyway, one of the things that occurred to me is that maybe
> some scripting work or a ReST extension could do something to parse
> "Documentation/foo" as :doc:`Documentation/foo` without needing to
> explicitly use any ReST specific tags.

That probably makes sense too. People do want to link to specific
subsections within documents, though; maybe we could allow
"Documentation/foo#bar" for that. Such "markup" could even be useful for
people reading the plain-text files.

Thanks,

jon