GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — Broken links on documentation download pages · Issue #95290 · python/cpython

Broken links on documentation download pages #95290

New issue
Copy link
New issue
Copy link
Closed
Closed
Broken links on documentation download pages#95290
Copy link
Labels
docsDocumentation in the Doc dirDocumentation in the Doc dir

Description

@hop
hop
opened on Jul 26, 2022
Issue body actions

I'm sorry, if there is a dedicated bug tracker for docs.python.org, I haven't been able to find it.

All links on https://docs.python.org/release/3.10.4/download.html (for all python versions) lead to a 404 page.

The links on that page are of the form:

https://docs.python.org/ftp/python/doc/3.10.4/python-3.10.4-docs-html.zip

which returns a 404 error.

The URL

https://docs.python.org/ftp/python/doc/3.10.4/

redirects to

https://www.python.org/ftp/python/doc/3.10.4/

(notice www. vs. docs.!) where all archives are present and downloadable.

I've verified this with curl on the command line. It is not a browswer issue.

Activity

  1. Mariatta commented on Jul 26, 2022

    @Mariatta
    Mariatta
    on Jul 26, 2022
    Member
    More actions

    This could be due to the docs are still being built, and not yet available for download. As the error message suggests, can you try again in a couple more hours?

  2. Mariatta
    transferred this issue frompython/pythondotorgon Jul 26, 2022
  3. AlexWaygood
    added
    docsDocumentation in the Doc dirDocumentation in the Doc dir
    on Jul 26, 2022
  4. hop commented on Jul 26, 2022

    @hop
    hop
    on Jul 26, 2022
    Author
    More actions

    As I wrote in my initial description: the docs are available for download

  5. hugovk commented on Jul 26, 2022

    @hugovk
    hugovk
    on Jul 26, 2022
    Member
    More actions

    The bottom of the pages says "Last updated on Mar 23, 2022" so these are old docs.

    https://docs.python.org/release/3.10.5/download.html is the latest 3.10, "Last updated on Jun 06, 2022", and has the same problem, so looks like a valid bug.

  6. hop commented on Jul 26, 2022

    @hop
    hop
    on Jul 26, 2022
    Author
    More actions

    As I said in my initial description: the download pages for all python versions have the same problem.

  7. hugovk commented on Jul 26, 2022

    @hugovk
    hugovk
    on Jul 26, 2022
    Member
    More actions

    Problem at https://github.com/python/cpython/blob/main/Doc/tools/templates/download.html with dlbase?

  8. arhadthedev commented on Jul 26, 2022

    @arhadthedev
    arhadthedev
    on Jul 26, 2022
    Member
    More actions

    @ned-deily Probably, #93853 (comment) should be reconsidered redesigned to not confuse doc readers.

  9. ned-deily commented on Jul 26, 2022

    @ned-deily
    ned-deily
    on Jul 26, 2022
    Member
    More actions

    There is something wrong in a website redirect because those downloads are on the dl server for those releases. I don't have time to look into that at the moment. There should be a redirect from, for example, https://docs.python.org/ftp/python/doc/3.10.5/python-3.10.5-docs-pdf-letter.zip to https://www.python.org/ftp/python/doc/3.10.5/python-3.10.5-docs-pdf-letter.zip that is not happening. Perhaps someone else can look into that.

  10. hop commented on Jul 26, 2022

    @hop
    hop
    on Jul 26, 2022
    Author
    More actions

    As I said, the redirect is there for the directory, but not for the archive files themselves.

    It's now been several hours and the problem persists, so even if this has to do with the build process as @Mariatta suggested, it looks like problem to me.

  11. encukou commented on Mar 23, 2023

    @encukou
    encukou
    on Mar 23, 2023
    Member
    More actions

    @ewdurbin, can you set up redirects from https://docs.python.org/ftp to https://www.python.org/ftp?
    As discussed above it would fix the docs download links, without needing to rebuild docs. IMO it's also better in long-term than changing build scripts, even though it'll be one more thing to think about if docs move to e.g. Read The Docs.

  12. ewdurbin commented on Mar 23, 2023

    @ewdurbin
    ewdurbin
    on Mar 23, 2023
    Member
    More actions

    Yeah, that is doable right now in our cdn configuration. Though it should also be doable here: https://github.com/python/psf-salt/blob/main/salt/docs/config/nginx.docs-backend.conf

  13. ewdurbin commented on Mar 23, 2023

    @ewdurbin
    ewdurbin
    on Mar 23, 2023
    Member
    More actions

    Unclear why this wouldn't be working: https://github.com/python/psf-salt/blob/d77665f2b77243e410eef2591abca8c65962975e/salt/docs/config/nginx.docs-backend.conf#L34C4-L37

  14. ewdurbin commented on Mar 23, 2023

    @ewdurbin
    ewdurbin
    on Mar 23, 2023
    Member
    More actions

    Oh, I see. That redirect should just need updated to match on the prefix /ftp. If anyone would like to open a PR to psf-salt I will happily review, merge, and deploy it.

  15. ewdurbin commented on Mar 23, 2023

    @ewdurbin
    ewdurbin
    on Mar 23, 2023
    Member
    More actions

    Best guess is there is a bad interaction with the block directly above the ftp redirect given the following:

    $ curl -s -I https://docs.python.org/ftp/python/doc/3.10.4/python-3.10.4-docs-html.zip
    HTTP/2 404 
    server: nginx
    content-type: text/html
    
    $ curl -s -I https://docs.python.org/ftp/python/doc/3.10.4/python-3.10.4-docs-html.zap
    HTTP/2 301 
    server: nginx
    content-type: text/html
    location: https://www.python.org/ftp/python/doc/3.10.4/python-3.10.4-docs-html.zap
    
    Reacted by Petr Viktorin
  16. ewdurbin commented on Mar 23, 2023

    @ewdurbin
    ewdurbin
    on Mar 23, 2023
    Member
    More actions

    looks resolved:

    $ curl -s -I https://docs.python.org/ftp/python/doc/3.10.4/python-3.10.4-docs-html.zip
    HTTP/2 404 
    server: nginx
    content-type: text/html
    $ curl -XPURGE https://docs.python.org/ftp/python/doc/3.10.4/python-3.10.4-docs-html.zip
    { "status": "ok", "id": "9222-1679515278-1" }
    $ curl -s -I https://docs.python.org/ftp/python/doc/3.10.4/python-3.10.4-docs-html.zip
    HTTP/2 301 
    server: nginx
    content-type: text/html
    location: https://www.python.org/ftp/python/doc/3.10.4/python-3.10.4-docs-html.zip
    

    note that it'll take some time for the current cached redirects to expire.

  17. hugovk commented on Mar 23, 2023

    @hugovk
    hugovk
    on Mar 23, 2023
    Member
    More actions

    Testing an arbitrary version, all the download links now work: https://docs.python.org/release/3.9.3/download.html

    Thanks!

  18. hugovk
    closed this as completedon Mar 23, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    docsDocumentation in the Doc dirDocumentation in the Doc dir

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions

      You are visitor 01402503 — GeezerVison does not store the pages you look up.
      Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.