This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: The link referring to "Python download page" is broken
Type: Stage: resolved
Components: Documentation Versions: Python 3.7, Python 3.6, Python 3.5, Python 2.7
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: docs@python Nosy List: cocoatomo, docs@python, ned.deily
Priority: normal Keywords:

Created on 2017-03-23 18:04 by cocoatomo, last changed 2022-04-11 14:58 by admin. This issue is now closed.

Pull Requests
URL Status Linked Edit
PR 820 closed cocoatomo, 2017-03-26 07:58
PR 823 merged cocoatomo, 2017-03-26 13:13
PR 824 merged cocoatomo, 2017-03-26 14:00
PR 826 merged ned.deily, 2017-03-26 17:44
PR 827 merged ned.deily, 2017-03-26 17:47
Messages (10)
msg290057 - (view) Author: Tomohiko Kinebuchi (cocoatomo) * Date: 2017-03-23 18:04
The download page [1]_ contains a link intended to refer to the release page of the corresponding Python version [2]_.

.. [1] `Download Python 2.7.13 Documentation <https://docs.python.org/2.7/download.html>`_

.. [2] e.g. `Python 2.7.8 Release <https://www.python.org/download/releases/2.7.8/>`_

Although, this link is broken for three reasons.

1. Wrong template syntax

   `Present code <https://github.com/python/cpython/blob/2.7/Doc/tools/templates/download.html#L78-L80>`_::

      <p>{% trans download_page="https://www.python.org/download/releases/{{ release[:5] }}/" %}HTML Help
      (<tt>.chm</tt>) files are made available in the "Windows" section
      on the <a href={{ download_page }}>Python download page</a>.{% endtrans %}</p>

   Fixed code::

      <p>{% trans download_page="https://www.python.org/download/releases/" + release[:5] + "/" %}HTML Help
      (<tt>.chm</tt>) files are made available in the "Windows" section
      on the <a href="{{ download_page }}">Python download page</a>.{% endtrans %}</p>

2. Unexpected version number

   The URL contains a Python version string (i.e. ``release[:5]``), but for Python 2.7.13, ``release[:5]`` evaluates to ``'2.7.1'`` which obviously wrong as a version string.

3. Non-existent release pages for some versions

   www.python.org has pages which URLs are https://www.python.org/download/releases/<version>/ with <version> = 2.7.1--8, although has no pages with <version> = 2.7.9 and so on.

   Is https://www.python.org/downloads/release/python-2713/ an appropriate page to refer?
msg290103 - (view) Author: Tomohiko Kinebuchi (cocoatomo) * Date: 2017-03-24 18:17
According to the table on the Downloads page [1]_, relations between Python versions and version specific release pages are listed as follows:

   2.7.0  -> https://www.python.org/download/releases/2.7/
   2.7.1  -> https://www.python.org/download/releases/2.7.1/
   2.7.2  -> https://www.python.org/download/releases/2.7.2/
   2.7.3  -> https://www.python.org/download/releases/2.7.3/
   2.7.4  -> https://www.python.org/download/releases/2.7.4/
   2.7.5  -> https://www.python.org/download/releases/2.7.5/
   2.7.6  -> https://www.python.org/download/releases/2.7.6/
   2.7.7  -> https://www.python.org/download/releases/2.7.7/
   2.7.8  -> https://www.python.org/downloads/release/python-278/
   2.7.9  -> https://www.python.org/downloads/release/python-279/
   2.7.10 -> https://www.python.org/downloads/release/python-2710/
   2.7.11 -> https://www.python.org/downloads/release/python-2711/
   2.7.12 -> https://www.python.org/downloads/release/python-2712/
   2.7.13 -> https://www.python.org/downloads/release/python-2713/

   3.0.0  -> https://www.python.org/download/releases/3.0/
   3.0.1  -> https://www.python.org/download/releases/3.0.1/

   3.1.0  -> https://www.python.org/download/releases/3.1/
   3.1.1  -> https://www.python.org/download/releases/3.1.1/
   3.1.2  -> https://www.python.org/download/releases/3.1.2/
   3.1.3  -> https://www.python.org/download/releases/3.1.3/
   3.1.4  -> https://www.python.org/download/releases/3.1.4/
   3.1.5  -> https://www.python.org/downloads/release/python-315/

   3.2.0  -> https://www.python.org/download/releases/3.2/
   3.2.1  -> https://www.python.org/download/releases/3.2.1/
   3.2.2  -> https://www.python.org/download/releases/3.2.2/
   3.2.3  -> https://www.python.org/download/releases/3.2.3/
   3.2.4  -> https://www.python.org/download/releases/3.2.4/
   3.2.5  -> https://www.python.org/download/releases/3.2.5/
   3.2.6  -> https://www.python.org/downloads/release/python-326/

   3.3.0  -> https://www.python.org/download/releases/3.3.0/
   3.3.1  -> https://www.python.org/download/releases/3.3.1/
   3.3.2  -> https://www.python.org/download/releases/3.3.2/
   3.3.3  -> https://www.python.org/download/releases/3.3.3/
   3.3.4  -> https://www.python.org/download/releases/3.3.4/
   3.3.5  -> https://www.python.org/download/releases/3.3.5/
   3.3.6  -> https://www.python.org/downloads/release/python-336/

   3.4.0  -> https://www.python.org/download/releases/3.4.0/
   3.4.1  -> https://www.python.org/downloads/release/python-341/
   3.4.2  -> https://www.python.org/downloads/release/python-342/
   3.4.3  -> https://www.python.org/downloads/release/python-343/
   3.4.4  -> https://www.python.org/downloads/release/python-344/
   3.4.5  -> https://www.python.org/downloads/release/python-345/
   3.4.6  -> https://www.python.org/downloads/release/python-346/

   3.5.0  -> https://www.python.org/downloads/release/python-350/
   3.5.1  -> https://www.python.org/downloads/release/python-351/
   3.5.2  -> https://www.python.org/downloads/release/python-352/
   3.5.3  -> https://www.python.org/downloads/release/python-353/

   3.6.0  -> https://www.python.org/downloads/release/python-360/
   3.6.1  -> https://www.python.org/downloads/release/python-361/


.. [1] https://www.python.org/downloads/

I will create a pull request for Python 2.7, 3.5 and 3.6.
msg290104 - (view) Author: Ned Deily (ned.deily) * (Python committer) Date: 2017-03-24 18:33
Thanks for noticing this.  The change in URLs was due to the introduction of the "new" python.org website a few years ago;  the canonical form of the URL for releases introduced after the move to the new web site is indeed  https://www.python.org/downloads/release/python-xyz/ so that should be the URL form used for current and future releases.  Another approach would be to add aliases on the web site to redirect from /releases/x.y.z to /release/python-xyz/ but, at this point, I don't think that's necessary.  A PR to fix the generated docs would be great.
msg290531 - (view) Author: Tomohiko Kinebuchi (cocoatomo) * Date: 2017-03-26 14:02
I just created two pull requests.

+ PR for 2.7 -> https://github.com/python/cpython/pull/823
+ PR for 3.5 or newer -> https://github.com/python/cpython/pull/824
msg290540 - (view) Author: Ned Deily (ned.deily) * (Python committer) Date: 2017-03-26 17:32
New changeset f8beb9831acd5cf80b9c56aea5864e16118c5400 by Ned Deily (cocoatomo) in branch 'master':
bpo-29888: Fix the link referring to the "Python download page" (GH-824)
https://github.com/python/cpython/commit/f8beb9831acd5cf80b9c56aea5864e16118c5400
msg290541 - (view) Author: Ned Deily (ned.deily) * (Python committer) Date: 2017-03-26 17:58
New changeset ceff32fb833e7be42508ffa73344e2e56865e54b by Ned Deily in branch '3.6':
bpo-29888: Fix the link referring to the "Python download page" (GH-824) (GH-826)
https://github.com/python/cpython/commit/ceff32fb833e7be42508ffa73344e2e56865e54b
msg290542 - (view) Author: Ned Deily (ned.deily) * (Python committer) Date: 2017-03-26 17:59
New changeset 8ce3085bf167b702989a9db466078b5676e825e3 by Ned Deily in branch '3.5':
bpo-29888: Fix the link referring to the "Python download page" (GH-824) (GH-827)
https://github.com/python/cpython/commit/8ce3085bf167b702989a9db466078b5676e825e3
msg290543 - (view) Author: Ned Deily (ned.deily) * (Python committer) Date: 2017-03-26 18:05
Thanks for the pull requests!  I've merged to master, 3.6, and 3.5 and I left a comment for the 2.7 PR.  By the way, next time you make a PR, please feel free to add your name to Misc/ACKS.
msg290556 - (view) Author: Tomohiko Kinebuchi (cocoatomo) * Date: 2017-03-27 01:52
@ned.deily Thank you for the commend. I updated the 2.7 PR.
msg290559 - (view) Author: Ned Deily (ned.deily) * (Python committer) Date: 2017-03-27 02:59
New changeset 6f95b37f290e0225aed5f8f7733ad0730601201b by Ned Deily (cocoatomo) in branch '2.7':
bpo-29888: Fix the link referring to "Python download page" (GH-823)
https://github.com/python/cpython/commit/6f95b37f290e0225aed5f8f7733ad0730601201b
History
Date User Action Args
2022-04-11 14:58:44adminsetgithub: 74074
2017-03-27 03:02:26ned.deilysetstatus: open -> closed
resolution: fixed
stage: commit review -> resolved
2017-03-27 02:59:16ned.deilysetmessages: + msg290559
2017-03-27 01:52:12cocoatomosetmessages: + msg290556
2017-03-26 18:05:03ned.deilysetstage: commit review
messages: + msg290543
versions: + Python 3.7
2017-03-26 17:59:03ned.deilysetmessages: + msg290542
2017-03-26 17:58:15ned.deilysetmessages: + msg290541
2017-03-26 17:47:07ned.deilysetpull_requests: + pull_request733
2017-03-26 17:44:11ned.deilysetpull_requests: + pull_request732
2017-03-26 17:32:27ned.deilysetmessages: + msg290540
2017-03-26 14:02:27cocoatomosetmessages: + msg290531
2017-03-26 14:00:32cocoatomosetpull_requests: + pull_request730
2017-03-26 13:13:18cocoatomosetpull_requests: + pull_request728
2017-03-26 07:58:33cocoatomosetpull_requests: + pull_request726
2017-03-24 18:33:26ned.deilysetnosy: + ned.deily
messages: + msg290104
2017-03-24 18:17:04cocoatomosetmessages: + msg290103
versions: + Python 3.5, Python 3.6
2017-03-23 18:04:23cocoatomocreate