You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
/Users/pradyunsg/Developer/pip/docs/html/cli/pip_freeze.rst:80: WARNING: hardcoded link 'https://github.com/pypa/pip/issues/8418' could be replaced by an extlink (try using ':issue:`8418`' instead)
This suggestion is suboptimal, since the equivalent replacement would actually be:
/Users/pradyunsg/Developer/pip/docs/html/development/architecture/anatomy.rst:3: WARNING: hardcoded link 'https://github.com/pypa/pip/issues/6831' could be replaced by an extlink (try using ':issue:`6831`' instead)
This suggestion is awkward, since there's no obvious way to make a drop-in replacement. Further, the line pointed to isn't the line with the actual URL to replace. Further, in case of multiple references to the same tracking issue, there's no way to use extlinks without duplicating the issue number in multiple places.
Describe the bug
The suggestions made in warnings by
extlinks
are incomplete, and not a drop-in replacement in most cases.For:
The warning presented is:
This suggestion is suboptimal, since the equivalent replacement would actually be:
For:
The warning presented is:
This suggestion is awkward, since there's no obvious way to make a drop-in replacement. Further, the line pointed to isn't the line with the actual URL to replace. Further, in case of multiple references to the same
tracking issue
, there's no way to use extlinks without duplicating the issue number in multiple places.How to Reproduce
(with a clean venv)
git clone https://github.com/pypa/pip
cd pip
pip install nox
nox -s docs
Expected behavior
No response
Your project
https://github.com/pypa/pip/
Screenshots
No response
OS
N/A
Python version
N/A
Sphinx version
4.4.0
Sphinx extensions
sphinx.ext.extlinks
Extra tools
No response
Additional context
No response
The text was updated successfully, but these errors were encountered: