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@python
components: Documentation
messages: 290057
nosy: cocoatomo, docs@python
priority: normal
severity: normal
status: open
title: The link referring to "Python download page" is broken
versions: Python 2.7

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue29888>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to