[New-bugs-announce] [issue29888] The link referring to "Python download page" is broken

[Kinebuchi Tomohiko]

New submission from Kinebuchi Tomohiko:

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?

----------
assignee: docs at python
components: Documentation
messages: 290057
nosy: cocoatomo, docs at python
priority: normal
severity: normal
status: open
title: The link referring to "Python download page" is broken
versions: Python 2.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29888>
_______________________________________