Merge "Add a section for contributing as a translator"

doc/source/code-and-documentation/index.rst

@@ -11,3 +11,4 @@ Code & Documentation Contributor Guide
    /common/git
    /common/setup-gerrit
    /common/task-tracking
+   /common/i18n

doc/source/common/i18n.rst

@@ -0,0 +1,51 @@
+##########################
+Contribute as a Translator
+##########################
+
+Abstract
+========
+
+If English is not your native language, you may wish to contribute as
+a translator. All services and documents that are visible
+to the user are translated by the I18n team. It does not matter which
+language you speak. We already have a lot of language teams who are very
+active. Our claim is more diversity, to support us in our work at I18n.
+
+Translation Platform
+====================
+
+We use `Zanata <http://zanata.org/>`_ as the platform for translating
+strings in software projects and documentation. Zanata provides web user
+interfaces: you only need a web browser to start your translation
+contribution. Our translation platform is reachable on
+`translate.openstack.org <https://translate.openstack.org/>`_
+
+.. image:: /_assets/i18n/zanata.png
+
+Zanata Usage
+============
+
+For registration and login you need an :doc:`OpenStack Foundation Account <accounts>`
+Click on *LogIn* on `translate.openstack.org <https://translate.openstack.org/>`_
+and follow the process for applying your Zanata profile.
+Once registered, you can join a language team.
+
+.. image:: /_assets/i18n/zanata_language.png
+
+Your membership application must be confirmed by the language
+coordinator. This may take some time. An e-mail with your request will
+be sent automatically.
+
+Choose a project where you want to contribute with translating. Usually
+there is a translation plan with priorities on the start page.
+
+.. image:: /_assets/i18n/zanata_workspace.png
+
+This is the view of the Zanata workspace. On the left side you have the
+original text string, while you can enter the translation on the right.
+
+Reference
+=========
+
+For more information please visit the `OpenStack I18n Guide <https://docs.openstack.org/i18n/latest/index.html>`_.
+This guide is also translatable.