i18n/doc/source/official_translator.rst
Akihiro Motoki 6a097119e0 Migrate ATC stats into the i18n repo
Currently ATC stats of the project is maintained by OpenStack wiki
but it looks better to manage it in the git repo.
While anyone can edit OpenStack wiki, all changes to the git repo
are reviewed before submitted.

This commit just converts all data from
https://wiki.openstack.org/wiki/I18nTeam/ATC_statistics
without any modifications.
The only exceptions are:
* username 'gael__' is escaped to 'gael\__'
  in doc/source/at-stats/data/newton.csv
  to prevent sphinx from interpreting it as a anonymous link
* The link of the diff in Mitaka cycle was wrong and
  it was fixed in this commit.

Change-Id: Ia91e0b3bce08369720493cf1d7d67c315cf3a35d
2017-08-04 16:41:36 +00:00

131 lines
5.0 KiB
ReStructuredText

=============================
Official OpenStack translator
=============================
Steps to become a OpenStack translator
--------------------------------------
Translation is another kind of important contribution to OpenStack
community. If you want to become a official translator, you need to
finish following steps:
1. Before you start contribution, you'll have to `agree
to the contributor license agreement
<http://docs.openstack.org/infra/manual/developers.html#account-setup>`_.
(You can preview the full text of `the OpenStack Individual
Contributor License Agreement
<https://review.openstack.org/static/cla.html>`_ first if you want.)
.. note::
If you want to become a translator only, simply speaking,
you need to `join The OpenStack Foundation
<https://www.openstack.org/join/>`_
(select "Foundation Member") and
`sign the appropriate Individual Contributor License Agreement
<http://docs.openstack.org/infra/manual/developers.html#sign-the-appropriate-individual-contributor-license-agreement>`_.
2. Register a user ID in Zanata
* Go to `Zanata server <https://translate.openstack.org/>`_
* Click "Log in" button.
* If you don't have OpenStack ID,
`register one <https://www.openstack.org/join/register>`_.
* After you log in with OpenStack ID, you will be requested to fill in
your profile.
.. note::
You are encouraged to register with your business email,
which will help your company to get the credit. If you don't
want to, use your personal email will be OK too.
3. Request to join a translation team
* Click "Languages" on the top, all languages will be listed.
* Click the language you want to translate, the language page will
be shown.
* Click "..." on the right, and select "Request to join team".
* Input a short introduction of yourself, including your name, as
"Additional information", then click "Send message".
.. note::
Make sure to include a short introduction because it is the
only information which language coordinators can use to
determine your join request is valid or not.
4. When your request is approved, you will get an email notification.
5. Now you can start your translation.
You can actually become an OpenStack official translator
by contributing translations.
You can find :doc:`various ways of contributions <contributing>`.
.. _i18n-atc:
ATC status in I18n project
--------------------------
The I18n project is an official OpenStack project, so official translators
who have contributed in a specific period are regarded as
"ATC" (Active Technical Contributor) and
"APC" (Active Project Contributor) of the I18n project.
APC can vote for the I18n PTL (Project Team Lead), and ATC
can vote for OpenStack TC (Technical Committee).
For more detail on ATC, APC and TC,
see `OpenStack Technical Committee Charter
<http://governance.openstack.org/reference/charter.html>`__.
As of now, ATC of official translators are treated as extra ATCs
as we have no way to collect statistics automatically now.
The list of extra ATCs is maintained by the PTL and is usually updated
short before the deadline of extra ATCs nomination in each release cycle.
The deadline of extra ATCs nomination can be checked in the release
schedule page at http://releases.openstack.org/ (for example,
http://releases.openstack.org/newton/schedule.html).
Translators who translate and review 300 and more words combinedly
in the last six months until the deadline of extra ATCs nomination are
nominated as ATCs, and the ATC status of translators is valid for one year.
Translation count and review count can be added up.
The detail period is determined by the PTL in each cycle.
For Newton cycle, the six month period was from 2016-02-01 to 2016-07-31,
and this ATC status will expire on July 2017 if there will be no
additional translation contributions.
.. note::
I18n PTL updates the list using Zanata API and translator list.
Detail statistics data is available :ref:`below <atc-stats>`.
If you have a question, feel free to ask it to the PTL or the i18n list.
Note that contributors to openstack/i18n repository are acknowledged
as ATC automatically in the same way as for most OpenStack projects.
.. _atc-stats:
ATC members of I18n project
---------------------------
A list of all ATCs is available at
http://governance.openstack.org/reference/projects/i18n.html#extra-atcs.
The statistics are calculated using
`a Python script <http://git.openstack.org/cgit/openstack/i18n/tree/tools/zanata/zanata_stats.py>`__
powered by
`Zanata statistics API <https://zanata.ci.cloudbees.com/job/zanata-api-site/site/zanata-common-api/rest-api-docs/resource_StatisticsResource.html>`__.
Translator list is maintained by
`translation_team.yaml <http://git.openstack.org/cgit/openstack/i18n/tree/tools/zanata/translation_team.yaml>`__
stored in `openstack/i18n git repository <http://git.openstack.org/cgit/openstack/i18n>`__.
ATC statistics of past releases are available below:
.. toctree::
:glob:
:reversed:
:maxdepth: 1
atc-stats/*