Re: [PATCH 2/6] docs-rst: update Sphinx install instructions

From: Jonathan Corbet
Date: Fri Jul 14 2017 - 11:44:17 EST


On Fri, 14 Jul 2017 08:08:19 -0300
Mauro Carvalho Chehab <mchehab@xxxxxxxxxxxxxxxx> wrote:

> +Please see :ref:`sphinx_install` at the doc-guide for details about
> +Sphinx requirements.

One small comment here: formatting things this way assumes that people are
reading the documentation in a web browser. Can we replace "at the
doc-guide" with "in Documentation/doc-guide/sphinx.rst" to improve the
usability of the plain-text files?

Otherwise the series looks good to me, thanks.

jon