Update translation/translators.rst

contrib/index.rst

@@ -75,7 +75,7 @@ major section at the top of each column.]*
        * :ref:`documenting`
        * :ref:`style-guide`
        * :ref:`rst-primer`
-       * :ref:`translating`
+       * :doc:`documentation/translations`
        * :ref:`devguide`
      -
        * :ref:`setup`

core-developers/experts.rst

@@ -372,4 +372,7 @@ version control     merwok, ezio-melotti
 Documentation translations
 ==========================
 
-For a list of translators, see :ref:`this table about translations <translating>`.
+Translations fall under the aegis of the
+`Editorial Board <https://python.github.io/editorial-board/>`_.
+For a list of translations and their coordinators, see
+:ref:`this table of translations <translation-coordinators>`.

documentation/translations/coordinating.rst

@@ -2,12 +2,17 @@
 Coordinating
 ============
 
+Python documentation translations are governed by :PEP:`545`.
+They are built by `docsbuild-scripts
+<https://github.com/python/docsbuild-scripts/>`__ and hosted on
+docs.python.org. Translations
+fall under the aegis of the `Editorial Board <EB_>`_
+
 Starting a new translation
 ==========================
 
 First subscribe to the `translation mailing list <translation_ml_>`_,
-and introduce yourself and the translation you're starting. Translations
-fall under the aegis of the `PSF Translation Workgroup <translation_wg_>`_
+and introduce yourself and the translation you're starting.
 
 Then you can bootstrap your new translation by using `cookiecutter
 <https://github.com/JulienPalard/python-docs-cookiecutter>`__ or
@@ -28,6 +33,16 @@ The important steps look like this:
   your language to be added in the language switcher on docs.python.org.
 
 
+How to get help
+===============
+
+Discussions about translations occur on the Python Docs Discord
+`#translations channel <https://discord.gg/h3qDwgyzga>`_, `translation
+mailing list <translation_ml_>`_, and the
+`translations subsection <https://discuss.python.org/c/documentation/translations/>`_
+of the Python Discourse.
+
+
 PEP 545 summary
 ===============
 
@@ -50,6 +65,13 @@ Here are the essential points of :PEP:`545`:
   ``https://docs.python.org/{LANGUAGE_TAG}/{VERSION_TAG}/``.
 
 
+Transifex
+=========
+
+If you need help from a Transifex administrator, open an issue on the
+`tracker <https://github.com/python-docs-translations/transifex-automations/issues>`_.
+
+
 Coordinating FAQ
 ================
 
@@ -73,7 +95,8 @@ __ https://github.com/python-docs-translations
 How is a coordinator elected?
 -----------------------------
 
-There is no election. Each translation will sort out the number of coordinators. We recommend 2 or 3 coordinators, though you may begin with one.  Here are some general suggestions.
+There is no election. Each translation will sort out the number of coordinators.
+We recommend 2 or 3 coordinators, though you may begin with one.  Here are some general suggestions.
 
 -  Coordinator requests are to be public on the `translation mailing list <translation_ml_>`_.
 -  If the given language has a native core dev, the core dev has input
@@ -113,11 +136,29 @@ files in the root of the repository using the ``gettext_compact=0``
 style.
 
 
-The entry for my translation is missing/not up to date on this page
--------------------------------------------------------------------
+.. XXX Explain necessary folder structure
+
+
+Which version of the Python documentation should be translated?
+---------------------------------------------------------------
+
+Consensus is to work on the current stable version. You can then propagate your
+translation from one branch to another using :pypi:`pomerge`.
+
+
+The entry for my translation is missing/not up to date
+------------------------------------------------------
 
 Ask on the `translation mailing list <translation_ml_>`_, or better, make a PR on the `devguide
 <https://github.com/python/devguide/>`__.
 
-.. _translation_wg: https://wiki.python.org/psf/TranslationWG/Charter
+
+Is there a Weblate instance we can translate on?
+------------------------------------------------
+
+There is currently no Weblate instance for use by Python translations because of
+certain limitations, these include word count limits and organization of
+translation source.
+
+.. _EB: https://python.github.io/editorial-board/
 .. _translation_ml: https://mail.python.org/mailman3/lists/translation.python.org/