Support community translators with documentation, etc (#6681)

Author: nlhkabu

.github/ISSUE_TEMPLATE/translation-issue.md

@@ -0,0 +1,34 @@
+---
+name: Translation issue
+about: Report a poor translation, poor source content, or ask for more
+information when making a translation
+
+---
+
+<!-- Uncomment the section most relevant to your issue -->
+
+<!--## Incorrect or suboptimal translation -->
+<!--
+  If you've found an incorrect or suboptimal translation and have a suggestion
+  on how to make it better, please visit
+  https://hosted.weblate.org/projects/pypa/warehouse/
+  to edit and/or comment on the translation
+-->
+
+<!-- ## Bad source in Weblate -->
+<!--
+  If you're translating PyPI and found a string that is either poorly
+  written or formatted, report it here.
+  Please include:
+    - a link to the source string (found in the Weblate sidebar)
+    - a description of the problem
+-->
+
+<!-- ## More information needed to translate effectively -->
+<!--
+  If you're translating PyPI and need more information about a string to
+  write a good translation, let us know.
+  Please include:
+  - a link to the source string (found in the Weblate sidebar)
+  - a description of the problem and what additional information you need
+-->

docs/index.rst

@@ -11,6 +11,7 @@ Contents:
    api-reference/index
    ui-principles
    security
+   translations
    roadmap
 
 Warehouse is a `web application`_ that implements the canonical

docs/translations.rst

@@ -0,0 +1,9 @@
+Translations
+============
+
+We use `Weblate <https://weblate.org/>`_ to manage PyPI translations. Visit the
+`Warehouse project on Weblate <https://hosted.weblate.org/projects/pypa/warehouse/>`_
+to contribute.
+
+If you are experiencing issues as a translator, please let us know by opening a
+`translation issue on the Warehouse issue tracker <https://github.com/pypa/warehouse/issues/new?template=translation-issue.md>`_.

warehouse/templates/base.html

@@ -283,6 +283,7 @@ <h2>{% trans %}Contributing to PyPI{% endtrans %}</h2>
             <ul>
               <li><a href="{{ request.route_path('help')}}#feedback">{% trans %}Bugs and feedback{% endtrans %}</a></li>
               <li><a href="https://github.com/pypa/warehouse" title="{% trans %}External link{% endtrans %}" target="_blank" rel="noopener">{% trans %}Contribute on GitHub{% endtrans %}</a></li>
+              <li><a href="https://hosted.weblate.org/projects/pypa/warehouse/" title="{% trans %}External link{% endtrans %}" target="_blank" rel="noopener">{% trans %}Translate PyPI{% endtrans %}</a></li>
               <li><a href="https://github.com/pypa/warehouse/graphs/contributors" title="{% trans %}External link{% endtrans %}" target="_blank" rel="noopener">{% trans %}Development credits{% endtrans %}</a></li>
             </ul>
           </nav>