Skip to content

Commit

Permalink
Minor updates
Browse files Browse the repository at this point in the history
  • Loading branch information
StanFromIreland committed Mar 7, 2025
1 parent a9bc51c commit abba60f
Showing 1 changed file with 16 additions and 16 deletions.
32 changes: 16 additions & 16 deletions peps/pep-0545.rst
Original file line number Diff line number Diff line change
Expand Up @@ -20,10 +20,10 @@ to attract and motivate new translators and new translations.
Translated documentation will be hosted on python.org. Examples of
two active translation teams:

* http://docs.python.org/fr/: French
* http://docs.python.org/ja/: Japanese
* https://docs.python.org/fr/: French
* https://docs.python.org/ja/: Japanese

http://docs.python.org/en/ will redirect to http://docs.python.org/.
https://docs.python.org/en/ will redirect to https://docs.python.org/.

Sources of translated documentation will be hosted in the Python
organization on GitHub: https://github.com/python/. Contributors will
Expand Down Expand Up @@ -77,22 +77,22 @@ Issue tracker

Considering that issues opened about translations may be written in
the translation language, which can be considered noise but at least
is inconsistent, issues should be placed outside `bugs.python.org
<https://bugs.python.org/>`_ (b.p.o).
is inconsistent, issues should not be placed in the `CPython issue tracker
<https://github.com/python/cpython/issues/>`_.

As all translation must have their own GitHub project (see `Repository
for Po Files`_), they must use the associated GitHub issue tracker.

Considering the noise induced by translation issues redacted in any
languages which may beyond every warnings land in b.p.o, triage will
languages which may beyond every warnings land in the issue tracker, triage will
have to be done. Considering that translations already exist and are
not actually a source of noise in b.p.o, an unmanageable amount of
not actually a source of noise in issue tracker, an unmanageable amount of
work is not to be expected. Considering that Xiang Zhang and Victor
Stinner are already triaging, and Julien Palard is willing to help on
this task, noise on b.p.o is not to be expected.
this task, noise on issue tracker is not to be expected.

Also, language team coordinators (see `Language Team`_) should help
with triaging b.p.o by properly indicating, in the language of the
with triaging the issue tracker by properly indicating, in the language of the
issue author if required, the right issue tracker.


Expand All @@ -106,10 +106,10 @@ done in one branch to other branches.
.. note::
Translation memories are a kind of database of previously translated
paragraphs, even removed ones. See also `Sphinx Internationalization
<http://www.sphinx-doc.org/en/stable/intl.html>`_.
<https://www.sphinx-doc.org/en/stable/intl.html>`_.

The three currently stable branches that will be translated are [12]_:
2.7, 3.5, and 3.6. The scripts to build the documentation of older
The newest currently stable branch will be translated and translations
can be propagated to other branches. The scripts to build the documentation of older
branches needs to be modified to support translation [12]_, whereas
these branches now only accept security-only fixes.

Expand Down Expand Up @@ -606,10 +606,10 @@ References
(https://git.afpy.org/AFPy/python-docs-fr)
.. [18] French mailing list
(http://lists.afpy.org/mailman/listinfo/traductions)
(https://lists.afpy.org/mailman/listinfo/traductions)
.. [19] Japanese translation
(http://docs.python.jp/3/)
(https://docs.python.jp/3/)
.. [20] Japanese translation on GitHub
(https://github.com/python-doc-ja/python-doc-ja)
Expand All @@ -627,10 +627,10 @@ References
(https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language)
.. [25] Документация Python 2.7!
(http://python-lab.ru/documentation/index.html)
(https://python-lab.ru/documentation/index.html)
.. [26] Python-oktató
(http://web.archive.org/web/20170526080729/http://harp.pythonanywhere.com/python_doc/tutorial/index.html)
(https://web.archive.org/web/20170526080729/http://harp.pythonanywhere.com/python_doc/tutorial/index.html)
.. [27] The Python-hu Archives
(https://mail.python.org/pipermail/python-hu/)
Expand Down

0 comments on commit abba60f

Please sign in to comment.