Skip to content

[Doc]: Broken links to fix in docs #30306

Open

Description

@dstansby

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

  1. Choose a link
  2. Try and access it in your web browser.
  3. If you can't access it, try and find where it's moved or find a suitable alternative link to include
  4. 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/ | Timeout

Fixed

Activity

  1. nrnavaneet commented on Jul 14, 2025

    @nrnavaneet
    Contributor

    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

  2. dstansby commented on Jul 15, 2025

    @dstansby
    MemberAuthor

    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.

  3. QuLogic commented on Jul 15, 2025

    @QuLogic
    Member

    You can ignore everything that's 404ing in https://matplotlib/stable/*; those are all the canonical reference URLs for new pages in devdocs that won't exist until a release is made.

  4. story645 commented on Jul 15, 2025

    @story645
    Member

    @dstansby I'm gonna assume we're not backporting these tfixes, is that ok?

  5. nrnavaneet commented on Jul 15, 2025

    @nrnavaneet
    Contributor

    @story645 Yes, that’s totally fine. Thanks for confirming! I’ll proceed with fixing only the current docs, no backports.

  6. story645 commented on Jul 15, 2025

    @story645
    Member

    @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.

  7. nrnavaneet commented on Jul 15, 2025

    @nrnavaneet
    Contributor

    Ah alright !

  8. dstansby commented on Jul 16, 2025

    @dstansby
    MemberAuthor

    @dstansby I'm gonna assume we're not backporting these tfixes, is that ok?

    Yes, I think that's fine, especially given lots of these links have probably been broken for a long time.

  9. nrnavaneet commented on Jul 16, 2025

    @nrnavaneet
    Contributor

    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

  10. nrnavaneet commented on Jul 16, 2025

    @nrnavaneet
    Contributor

    @dstansby Could you please confirm if it's okay to remove the mention of detox and the http://pypi.testrun.org link from doc/devel/testing.rst since detox is now deprecated and the link is dead? I can update the section to reflect modern alternatives like GNU parallel. Let me know your thoughts. Thanks!

  11. aishwaryabnateekar-ui commented on Mar 15, 2026

    @aishwaryabnateekar-ui

    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?

  12. rcomer commented on Mar 15, 2026

    @rcomer
    Member

    @aishwaryabnateekar-ui please read the original post. Both a list of broken links and the method for finding them are shown.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions