diff --git a/doc/source/_assets/i18n/zanata.png b/doc/source/_assets/i18n/zanata.png new file mode 100644 index 0000000..0945b95 Binary files /dev/null and b/doc/source/_assets/i18n/zanata.png differ diff --git a/doc/source/_assets/i18n/zanata_language.png b/doc/source/_assets/i18n/zanata_language.png new file mode 100644 index 0000000..2b7571d Binary files /dev/null and b/doc/source/_assets/i18n/zanata_language.png differ diff --git a/doc/source/_assets/i18n/zanata_workspace.png b/doc/source/_assets/i18n/zanata_workspace.png new file mode 100644 index 0000000..54c7709 Binary files /dev/null and b/doc/source/_assets/i18n/zanata_workspace.png differ diff --git a/doc/source/code-and-documentation/index.rst b/doc/source/code-and-documentation/index.rst index 0e1d60d..c8df4e9 100644 --- a/doc/source/code-and-documentation/index.rst +++ b/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 diff --git a/doc/source/common/i18n.rst b/doc/source/common/i18n.rst new file mode 100644 index 0000000..586a76d --- /dev/null +++ b/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 `_ 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 `_ + +.. image:: /_assets/i18n/zanata.png + +Zanata Usage +============ + +For registration and login you need an :doc:`OpenStack Foundation Account ` +Click on *LogIn* on `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 `_. +This guide is also translatable.