restore a broken slug anchor in user guide

[wimglenn]

ping @uranusjr , @di

[uranusjr]

Rendered preview to confirm the anchor is fixed.

Test failures are unrelated, caused by availability issues of http://svn.colorstudy.com.

Can you add a 8781.doc news fragment to describe this change?

[eamanu]

LGTM after add news

[uranusjr]

Linting error is

Warning, treated as error:
docs/html/installing.rst:40:term not in glossary: pypug:source distribution (or "sdist")
ERROR: InvocationError for command .tox/docs/bin/sphinx-build -W -d .tox/docs/tmp/doctrees/html -b html docs/html docs/build/html (exited with code 2)

Seems unrelated? But why does master not fail?

[eamanu]

Linting error is

Warning, treated as error:
docs/html/installing.rst:40:term not in glossary: pypug:source distribution (or "sdist")
ERROR: InvocationError for command .tox/docs/bin/sphinx-build -W -d .tox/docs/tmp/doctrees/html -b html docs/html docs/build/html (exited with code 2)

Seems unrelated? But why does master not fail?

hmm weird, what about re run?

[eamanu]

Same here: #8771

[eamanu]

@uranusjr I can reproduce the error locally. I'm not expert with sphinx but seems that the reference to https://github.com/pypa/packaging.python.org/blame/master/source/glossary.rst#L209 is not successfully.

/home/eamanu/dev/pip/.tox/docs/bin/sphinx-build -W -d /home/eamanu/dev/pip/.tox/docs/tmp/doctrees/html -b html docs/html docs/build/html
Running Sphinx v2.4.3
20.3
loading intersphinx inventory from https://packaging.python.org/objects.inv...
loading intersphinx inventory from https://www.pypa.io/en/latest/objects.inv...
building [mo]: targets for 0 po files that are out of date
building [html]: targets for 39 source files that are out of date
updating environment: [new config] 39 added, 0 changed, 0 removed
reading sources... [100%] user_guide                                                                                                                                                                                                                                                                                         
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
preparing documents... done
writing output... [100%] user_guide                                                                                                                                                                                                                                                                                          

Warning, treated as error:
/home/eamanu/dev/pip/docs/html/installing.rst:40:term not in glossary: pypug:source distribution (or "sdist")

IMO there is some new on sphinx that break that behaviour. But again, I'm not expert and I don't have evidences of the problem.

Tomorrow I can continue looking that

[pradyunsg]

It's case-sensitive now, IIUC -- maybe that's why?

[pradyunsg]

https://travis-ci.com/github/pypa/pip/jobs/375534050 -- looks like master is failing as well.

[McSinyx]

It's case-sensitive now, IIUC -- maybe that's why?

Unlikely, since only in the error that it is pypug:source distribution (or "sdist"); in the reST source it's the same as the term defined in the PUG:

pip/docs/html/installing.rst

Line 42 in e1d489f

:term:`source distributions <pypug:Source Distribution (or "sdist")>`. Both are

As analyzed by @shireenrao in #8650 (comment), this might have to do with Sphinx version compatibility (given the PUG has recently upgraded to use Sphinx 3.2.0). For this very moment I suggest temporary dropping the glossary reference until we solve the root cause in the progress of upgrading to the latest Sphinx as well. Edit: see per PR below—just upgrading Sphinx to 3.2.1 makes it green 🚀🚀🚀

[McSinyx]

I believe that this was closed accidentally.

[pradyunsg]

LGTM! Happy to merge once CI is green (which it should be soon-enough). :)