OK, I see. I think you are right that this is ovekill for this particular
README.rst.


On Fri, Jul 19, 2013 at 8:52 AM, Feth Arezki <notifications@github.com>wrote:

> In doc/README.rst:
>
> > +    python make.py html
> > +
> > +from within the current directory (``doc``). The gallery is built at
> > +build/html/gallery.html.
> > +
> > +Complete documentation
> > +^^^^^^^^^^^^^^^^^^^^^^
> > +
> > +Now the documentation build is completed by repeating the same command:
> > +
> > +::
> > +
> > +    python make.py html
> > +
> > +The entry point for the HTML documentation is now available at
> > +`build/html/index.html <./build/html/index.html>`__.
>
> I don't have enough context on this subject to say if the following is
> appropriate here or (likely) not:
> All urls could be listed in a 'urls.rst' file that can be included from
> any other file, and works like a bibtex. So it's not polluting the user's
> entrypoint that is a Readme file.
>
> —
> Reply to this email directly or view it on GitHub<https://github.com/matplotlib/matplotlib/pull/2227/files#r5292383>
> .
>



-- 
Dr. David P. Sanders

Profesor Titular "A" / Associate Professor
Departamento de Física, Facultad de Ciencias
Universidad Nacional Autónoma de México (UNAM)

dpsanders@gmail.com
http://sistemas.fciencias.unam.mx/~dsanders

Cubículo / office: #414, 4o. piso del Depto. de Física

Tel.: +52 55 5622 4965