Repository navigation
Description
Documentation Link
No response
Problem
There are several broken links in our docs. There is a proposal to automate finding these at #5380, but this issue collates existing broken links that need fixing.
How to fix
- Choose a link
- Try and access it in your web browser.
- If you can't access it, try and find where it's moved or find a suitable alternative link to include
- Submit a pull request with the fixed link
How I found these
I build the HTML docs, then used lychee with
lychee . --exclude https://github.com/matplotlib/matplotlib --verbose --exclude file:///Users/dstansby/software/mpl/matplotlib/doc/build --threads 1 --max-cache-age=0d --timeout=20 --max-concurrency 32 --exclude https://matplotlib.org/stable/users/next_whats_new
The errors
Issues found in inputs. Find details below.
[./html/_sources/api/toolkits/mplot3d/view_angles.rst.txt]:
[403] https://www.mathworks.com/help/matlab/ref/view.html | Rejected status code (this depends on your "accept" configuration): Forbidden
[403] https://www.researchgate.net/publication/8329656_Virtual_Trackballs_Revisited#fullTextFileContent | Rejected status code (this depends on your "accept" configuration): Forbidden
[./html/_sources/devel/communication_guide.rst.txt]:
[403] https://help.x.com/en/rules-and-policies/x-rules | Error (cached)
[400] https://x.com/matplotlib | Error (cached)
[./html/_sources/devel/document.rst.txt]:
[404] http://matplotlib.org/stable/old_topic/old_info2 | Rejected status code (this depends on your "accept" configuration): Not Found
[403] https://stackoverflow.com/a/4836544 | Rejected status code (this depends on your "accept" configuration): Forbidden
[./html/_sources/devel/MEP/MEP10.rst.txt]:
[404] https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt | Error (cached)
[./html/_sources/devel/MEP/MEP11.rst.txt]:
[522] http://grokbase.com/t/python/distutils-sig/109bdnfhp4/distutils-ann-setuptools-post-install-script-for-bdist-wininst | Rejected status code (this depends on your "accept" configuration): Unknown status code
[404] https://setuptools.readthedocs.io/en/latest/easy_install.html | Error (cached)
[./html/_sources/devel/testing.rst.txt]:
[ERROR] http://pypi.testrun.org/ | Network error: error sending request for url (http://pypi.testrun.org/) Maybe a certificate error?
[404] https://github.com/your_GitHub_user_name/matplotlib/actions | Error (cached)
[./html/_sources/gallery/shapes_and_collections/dolphin.rst.txt]:
[404] http://web.resource.org/cc/DerivativeWorks | Rejected status code (this depends on your "accept" configuration): Not Found
[404] http://web.resource.org/cc/Distribution | Rejected status code (this depends on your "accept" configuration): Not Found
[404] http://web.resource.org/cc/PublicDomain | Rejected status code (this depends on your "accept" configuration): Not Found
[404] http://web.resource.org/cc/Reproduction | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/_sources/gallery/user_interfaces/embedding_in_wx5_sgskip.rst.txt]:
[404] http://wiki.wxpython.org/Widget%20Inspection%20Tool | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/_sources/project/history.rst.txt]:
[TIMEOUT] https://acrobat.adobe.com/us/en/acrobat/about-adobe-pdf.html | Timeout
[ERROR] https://www.adobe.com/products/postscript.html | Network error: error sending request for url (https://www.adobe.com/products/postscript.html)
[./html/_sources/users/explain/colors/colormaps.rst.txt]:
[403] https://stackoverflow.com/q/8202605/ | Rejected status code (this depends on your "accept" configuration): Forbidden
[./html/_sources/users/explain/text/fonts.rst.txt]:
[TIMEOUT] https://helpx.adobe.com/fonts/kb/postscript-type-1-fonts-end-of-support.html | Timeout
[./html/_sources/users/explain/text/pgf.rst.txt]:
[403] https://tex.stackexchange.com/q/7953/ | Rejected status code (this depends on your "accept" configuration): Forbidden
[403] https://tex.stackexchange.com/q/43642/ | Rejected status code (this depends on your "accept" configuration): Forbidden
[./html/_sources/users/explain/text/text_props.rst.txt]:
[403] https://linux.die.net/man/1/fc-list | Rejected status code (this depends on your "accept" configuration): Forbidden
[./html/_sources/users/faq.rst.txt]:
[403] https://stackoverflow.com/questions/tagged/matplotlib | Rejected status code (this depends on your "accept" configuration): Forbidden
[./html/_sources/users/prev_whats_new/changelog.rst.txt]:
[404] http://sourceforge.net/tracker/index.php?func=detail&aid=1587359&group_id=80706&atid=560722 | Rejected status code (this depends on your "accept" configuration): Not Found
[404] http://sourceforge.net/tracker/index.php?func=detail&aid=1716732&group_id=80706&atid=560720 | Rejected status code (this depends on your "accept" configuration): Not Found
[404] http://sourceforge.net/tracker/index.php?func=detail&aid=1744154&group_id=80706&atid=560720 | Rejected status code (this depends on your "accept" configuration): Not Found
[404] http://sourceforge.net/tracker/index.php?func=detail&aid=1866207&group_id=80706&atid=560722 | Rejected status code (this depends on your "accept" configuration): Not Found
[404] http://sourceforge.net/tracker/index.php?func=detail&aid=1962574&group_id=80706&atid=560720 | Rejected status code (this depends on your "accept" configuration): Not Found
[ERROR] http://www.voidspace.org.uk/python/configobj.html | Network error: error sending request for url (http://www.voidspace.org.uk/python/configobj.html) Maybe a certificate error?
[404] https://sourceforge.net/tracker/index.php?func=detail&aid=1986597&group_id=80706&atid=560720 | Rejected status code (this depends on your "accept" configuration): Not Found
[404] https://sourceforge.net/tracker/index.php?func=detail&aid=2823304&group_id=80706&atid=560720 | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/_sources/users/prev_whats_new/whats_new_3.10.0.rst.txt]:
[429] https://doi.org/10.5281/zenodo.1243862 | Rejected status code (this depends on your "accept" configuration): Too Many Requests
[./html/_sources/users/resources/index.rst.txt]:
[TIMEOUT] https://www.labri.fr/perso/nrougier/teaching/matplotlib/ | Timeout
[./html/_tags/interactivity-event-handling.html]:
[404] https://matplotlib.org/stable/_tags/interactivity-event-handling.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/_tags/plot-type-image.html]:
[404] https://matplotlib.org/stable/_tags/plot-type-image.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/_as_gen/matplotlib.axes.Axes.get_xinverted.html]:
[404] https://matplotlib.org/stable/api/_as_gen/matplotlib.axes.Axes.get_xinverted.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/_as_gen/matplotlib.axes.Axes.get_yinverted.html]:
[404] https://matplotlib.org/stable/api/_as_gen/matplotlib.axes.Axes.get_yinverted.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/_as_gen/matplotlib.axes.Axes.grouped_bar.html]:
[404] https://matplotlib.org/stable/api/_as_gen/matplotlib.axes.Axes.grouped_bar.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/_as_gen/matplotlib.axes.Axes.set_xinverted.html]:
[404] https://matplotlib.org/stable/api/_as_gen/matplotlib.axes.Axes.set_xinverted.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/_as_gen/matplotlib.axes.Axes.set_yinverted.html]:
[404] https://matplotlib.org/stable/api/_as_gen/matplotlib.axes.Axes.set_yinverted.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/_as_gen/matplotlib.axes.Axes.stem.html]:
[403] https://www.mathworks.com/help/matlab/ref/stem.html | Rejected status code (this depends on your "accept" configuration): Forbidden
[./html/api/_as_gen/matplotlib.colors.Norm.html]:
[404] https://matplotlib.org/stable/api/_as_gen/matplotlib.colors.Norm.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/_as_gen/matplotlib.pyplot.grouped_bar.html]:
[404] https://matplotlib.org/stable/api/_as_gen/matplotlib.pyplot.grouped_bar.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/_as_gen/matplotlib.pyplot.stem.html]:
[403] https://www.mathworks.com/help/matlab/ref/stem.html | Error (cached)
[./html/api/_as_gen/mpl_toolkits.mplot3d.axes3d.Axes3D.get_xinverted.html]:
[404] https://matplotlib.org/stable/api/_as_gen/mpl_toolkits.mplot3d.axes3d.Axes3D.get_xinverted.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/_as_gen/mpl_toolkits.mplot3d.axes3d.Axes3D.get_yinverted.html]:
[404] https://matplotlib.org/stable/api/_as_gen/mpl_toolkits.mplot3d.axes3d.Axes3D.get_yinverted.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/_as_gen/mpl_toolkits.mplot3d.axes3d.Axes3D.get_zinverted.html]:
[404] https://matplotlib.org/stable/api/_as_gen/mpl_toolkits.mplot3d.axes3d.Axes3D.get_zinverted.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/_as_gen/mpl_toolkits.mplot3d.axes3d.Axes3D.set_xinverted.html]:
[404] https://matplotlib.org/stable/api/_as_gen/mpl_toolkits.mplot3d.axes3d.Axes3D.set_xinverted.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/_as_gen/mpl_toolkits.mplot3d.axes3d.Axes3D.set_yinverted.html]:
[404] https://matplotlib.org/stable/api/_as_gen/mpl_toolkits.mplot3d.axes3d.Axes3D.set_yinverted.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/_as_gen/mpl_toolkits.mplot3d.axes3d.Axes3D.set_zinverted.html]:
[404] https://matplotlib.org/stable/api/_as_gen/mpl_toolkits.mplot3d.axes3d.Axes3D.set_zinverted.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/backend_bases_api.html]:
[ERROR] https://www.adobe.com/jp/print/postscript/pdfs/PLRM.pdf | Network error: error sending request for url (https://www.adobe.com/jp/print/postscript/pdfs/PLRM.pdf)
[./html/api/backend_cairo_api.html]:
[TIMEOUT] https://www.adobe.com/jp/print/postscript/pdfs/PLRM.pdf | Timeout
[./html/api/next_api_changes/behavior/28437-CH.html]:
[404] https://matplotlib.org/stable/api/next_api_changes/behavior/28437-CH.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/next_api_changes/behavior/29054-AL.html]:
[404] https://matplotlib.org/stable/api/next_api_changes/behavior/29054-AL.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/next_api_changes/behavior/29256_IMT.html]:
[404] https://matplotlib.org/stable/api/next_api_changes/behavior/29256_IMT.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/next_api_changes/behavior/29827-ES.html]:
[404] https://matplotlib.org/stable/api/next_api_changes/behavior/29827-ES.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/next_api_changes/behavior/29832-REC.html]:
[404] https://matplotlib.org/stable/api/next_api_changes/behavior/29832-REC.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/next_api_changes/deprecations/27551-AL.html]:
[404] https://matplotlib.org/stable/api/next_api_changes/deprecations/27551-AL.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/next_api_changes/deprecations/27972-AL.html]:
[404] https://matplotlib.org/stable/api/next_api_changes/deprecations/27972-AL.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/next_api_changes/deprecations/29135-TH.html]:
[404] https://matplotlib.org/stable/api/next_api_changes/deprecations/29135-TH.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/next_api_changes/deprecations/29529-TH.html]:
[404] https://matplotlib.org/stable/api/next_api_changes/deprecations/29529-TH.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/next_api_changes/deprecations/29817-AL.html]:
[404] https://matplotlib.org/stable/api/next_api_changes/deprecations/29817-AL.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/next_api_changes/deprecations/29904-tac.html]:
[404] https://matplotlib.org/stable/api/next_api_changes/deprecations/29904-tac.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/next_api_changes/deprecations/30027-AL.html]:
[404] https://matplotlib.org/stable/api/next_api_changes/deprecations/30027-AL.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/next_api_changes/deprecations/30044-AL.html]:
[404] https://matplotlib.org/stable/api/next_api_changes/deprecations/30044-AL.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/next_api_changes/deprecations/30070-OG.html]:
[404] https://matplotlib.org/stable/api/next_api_changes/deprecations/30070-OG.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/next_api_changes/deprecations/30088-AL.html]:
[404] https://matplotlib.org/stable/api/next_api_changes/deprecations/30088-AL.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/next_api_changes/deprecations/30163-AL.html]:
[404] https://matplotlib.org/stable/api/next_api_changes/deprecations/30163-AL.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/next_api_changes/development/29745-DS.html]:
[404] https://matplotlib.org/stable/api/next_api_changes/development/29745-DS.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/next_api_changes/removals/29697-REC.html]:
[404] https://matplotlib.org/stable/api/next_api_changes/removals/29697-REC.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/next_api_changes/removals/30004-DS.html]:
[404] https://matplotlib.org/stable/api/next_api_changes/removals/30004-DS.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/next_api_changes/removals/30005-DS.html]:
[404] https://matplotlib.org/stable/api/next_api_changes/removals/30005-DS.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/next_api_changes/removals/30014-DS.html]:
[404] https://matplotlib.org/stable/api/next_api_changes/removals/30014-DS.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/next_api_changes/removals/30015-DS.html]:
[404] https://matplotlib.org/stable/api/next_api_changes/removals/30015-DS.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/next_api_changes/removals/30067-OG.html]:
[404] https://matplotlib.org/stable/api/next_api_changes/removals/30067-OG.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/api/prev_api_changes/api_changes_0.99.x.html]:
[ERROR] http://www.voidspace.org.uk/python/configobj.html | Error (cached)
[./html/api/toolkits/mplot3d/view_angles.html]:
[403] https://www.mathworks.com/help/matlab/ref/view.html | Error (cached)
[403] https://www.researchgate.net/publication/8329656_Virtual_Trackballs_Revisited#fullTextFileContent | Error (cached)
[./html/devel/communication_guide.html]:
[403] https://help.x.com/en/rules-and-policies/x-rules | Rejected status code (this depends on your "accept" configuration): Forbidden
[400] https://x.com/matplotlib | Rejected status code (this depends on your "accept" configuration): Bad Request
[./html/devel/MEP/MEP10.html]:
[404] https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/devel/MEP/MEP11.html]:
[522] http://grokbase.com/t/python/distutils-sig/109bdnfhp4/distutils-ann-setuptools-post-install-script-for-bdist-wininst | Rejected status code (this depends on your "accept" configuration): Unknown status code
[404] https://setuptools.readthedocs.io/en/latest/easy_install.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/devel/MEP/MEP14.html]:
[ERROR] https://pango.gnome.org/ | Network error: error sending request for url (https://pango.gnome.org/) Maybe a certificate error?
[./html/devel/testing.html]:
[404] https://github.com/your_GitHub_user_name/matplotlib/actions | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/gallery/color/colorbar_histogram.html]:
[404] https://matplotlib.org/stable/gallery/color/colorbar_histogram.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/gallery/images_contours_and_fields/image_exact_placement.html]:
[404] https://matplotlib.org/stable/gallery/images_contours_and_fields/image_exact_placement.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/gallery/shapes_and_collections/hatchcolor_demo.html]:
[404] https://matplotlib.org/stable/gallery/shapes_and_collections/hatchcolor_demo.html | Rejected status code (this depends on your "accept" configuration): Not Found
[./html/project/history.html]:
[TIMEOUT] https://acrobat.adobe.com/us/en/acrobat/about-adobe-pdf.html | Timeout
[ERROR] https://www.adobe.com/products/postscript.html | Network error: error sending request for url (https://www.adobe.com/products/postscript.html)
[./html/users/explain/text/fonts.html]:
[TIMEOUT] https://helpx.adobe.com/fonts/kb/postscript-type-1-fonts-end-of-support.html | Timeout
[./html/users/explain/text/pgf.html]:
[403] https://tex.stackexchange.com/q/7953/ | Error (cached)
[403] https://tex.stackexchange.com/q/43642/ | Error (cached)
[./html/users/explain/text/text_props.html]:
[403] https://linux.die.net/man/1/fc-list | Error (cached)
[./html/users/faq.html]:
[403] https://stackoverflow.com/questions/tagged/matplotlib | Error (cached)
[./html/users/resources/index.html]:
[TIMEOUT] https://www.labri.fr/perso/nrougier/teaching/matplotlib/ | TimeoutFixed
-
[./html/_sources/devel/MEP/MEP14.rst.txt]:
[ERROR] https://pango.gnome.org/ | Error (cached) Fix link to pango #30315 -
[./html/users/prev_whats_new/changelog.html]:
[ERROR] http://www.voidspace.org.uk/python/configobj.html | Error (cached) fix broken configobj link #30317 -
[./html/devel/MEP/MEP10.html]:
[404] https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt | Rejected status code (this depends on your "accept" configuration): Not Found Fix broken/deprecated documentation links in MEPs and testing guides #30343 -
[./html/devel/MEP/MEP11.html]:
[522] http://grokbase.com/t/python/distutils-sig/109bdnfhp4/distutils-ann-setuptools-post-install-script-for-bdist-wininst | Rejected status code (this depends on your "accept" configuration): Unknown status code
[404] https://setuptools.readthedocs.io/en/latest/easy_install.html | Rejected status code (this depends on your "accept" configuration): Not Found Fix broken/deprecated documentation links in MEPs and testing guides #30343 -
[./html/_sources/devel/testing.rst.txt]:
[ERROR] http://pypi.testrun.org/ | Network error: error sending request for url (http://pypi.testrun.org/) Maybe a certificate error?
[404] https://github.com/your_GitHub_user_name/matplotlib/actions | Error (cached) Fix broken/deprecated documentation links in MEPs and testing guides #30343
Activity
nrnavaneet commentedon Jul 14, 2025
Hi @dstansby! I'd like to work on this issue starting with fixing the broken link in
api_changes_0.71.rst.txt. Please let me know if there are any preferences regarding replacements.Happy to draft a PR.
Thank you
dstansby commentedon Jul 15, 2025
I think the historic links in the API changes don't need fixing actually - I removed them above. Sorry about that - I'd recommend choosing another one. In terms of finding a replacement URL, you'll have to work that out yourself to find a suitable alternative :). Some links will redirect which makes them easy - broken links will be trickier, and you'll have to understand a bit their context to find a suitable alternative link.
QuLogic commentedon Jul 15, 2025
You can ignore everything that's 404ing in
https://matplotlib/stable/*; those are all the canonical reference URLs for new pages indevdocsthat won't exist until a release is made.story645 commentedon Jul 15, 2025
@dstansby I'm gonna assume we're not backporting these tfixes, is that ok?
nrnavaneet commentedon Jul 15, 2025
@story645 Yes, that’s totally fine. Thanks for confirming! I’ll proceed with fixing only the current docs, no backports.
story645 commentedon Jul 15, 2025
@nrnavaneet I think you misunderstood me. Typically documentation fixes are back-ported when merged, but I'm not sure if that policy should apply here.
You're by default working on the current documentation if you're working on the main branch of this repository.
nrnavaneet commentedon Jul 15, 2025
Ah alright !
dstansby commentedon Jul 16, 2025
Yes, I think that's fine, especially given lots of these links have probably been broken for a long time.
nrnavaneet commentedon Jul 16, 2025
Hi! @dstansby @story645
While running lychee to check for broken links, I found some links that no longer accessible (404 errors) like:
Would you prefer these be:
1.Removed entirely since the content is no longer available?
2.Replaced with a general summary or alternate link (if any exist)?
3.Left as-is with a note about them being unavailable?
Kindly let me know
nrnavaneet commentedon Jul 16, 2025
@dstansby Could you please confirm if it's okay to remove the mention of
detoxand thehttp://pypi.testrun.orglink fromdoc/devel/testing.rstsincedetoxis now deprecated and the link is dead? I can update the section to reflect modern alternatives likeGNU parallel. Let me know your thoughts. Thanks!aishwaryabnateekar-ui commentedon Mar 15, 2026
Hi! I’m exploring this issue as a beginner contributor.
Could you point to one specific broken link that would
be a good starting point to fix?
rcomer commentedon Mar 15, 2026
@aishwaryabnateekar-ui please read the original post. Both a list of broken links and the method for finding them are shown.
DOC: replace dolphin license RDF block with prose attribution
DOC: fix broken link to wxPython Widget Inspection Tool (#31535)