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.

Author rffontenelle
Recipients docs@python, rffontenelle
Date 2021-12-19.10:22:01
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1639909321.54.0.519282001136.issue46130@roundup.psfhosted.org>
In-reply-to
Content
The following string can be found in What's New in Python 3.10 source file (Doc/whatsnew/3.10.rst):

> For major changes, see `New Features Related to Type Hints`_.

where "`New Features Related to Type Hints`_" is a link to a section in the very same page with this name.

The issue with this link text is that translators should translate it (in python-doc organization in Transifex) but warning as errors will pop up if translated. For example, in Portuguese:

> Para mais alterações, veja `Novos recrusos relacionados a dicas de tipo`_

or to

> Para mais alterações, veja `Novos recrusos relacionados a dicas de tipo <New Features Related to Type Hints>`_

Sphinx would complain with:

Doc/whatsnew/3.10.rst:1432: WARNING: inconsistent references in translated message. original: ['`New Features Related to Type Hints`_'], translated: []

To solve this issue, I see two solutions:

1- Create an anchor for "New Features Related to Type Hints" section in this page (let's say, "new-feat-related-type-hints") and then call it like :ref:`new-feat-related-type-hints` so that it gets the section title name automatically. Translators won't need to edit it in order to get translated title name. (recommended)

2- Rewrite the source string adding the internal link to the paragraph using `New Features Related to Type Hints <#new-features-related-to-type-hints>`_, so that it can be translated without popping up the warning message.
History
Date User Action Args
2021-12-19 10:22:01rffontenellesetrecipients: + rffontenelle, docs@python
2021-12-19 10:22:01rffontenellesetmessageid: <1639909321.54.0.519282001136.issue46130@roundup.psfhosted.org>
2021-12-19 10:22:01rffontenellelinkissue46130 messages
2021-12-19 10:22:01rffontenellecreate