Improve Stackalytics FAQ

Change-Id: I1adc5befdcd1eb6e577d353a20664f64a356d175
This commit is contained in:
Akihiro Motoki 2016-06-07 01:19:49 +09:00
parent 29054aa7d8
commit 32b8c52435
1 changed files with 22 additions and 11 deletions

View File

@ -27,16 +27,32 @@ It supports translation statistics :)
Visit `Stackalytics <http://stackalytics.com/>`__ and
choose ``Translations`` as ``Metric`` dropdown menu at the upper-right.
FAQ: I cannot find my name in Stackalytics.
-------------------------------------------
FAQ: I cannot find my name in Stackalytics
------------------------------------------
There is a case where you cannot see your translation statistics
There are cases where you cannot see your translation statistics
in Stackalytics even after you translate strings in Zanata.
Do you use a same ID for launchpad and Zanata?
If they are different, Stackalytics will not find your translation counts.
Here is the check list for such case:
In this case, you need to let Stackalytics know your ID mappings.
* Is your Zanata ID included in the `translator list
<http://git.openstack.org/cgit/openstack/i18n/tree/tools/zanata/translation_team.yaml>`__?
* Is your Zanata ID different from your launchpad ID?
If your Zanata ID is not included in the translator list,
you need to add your Zanata ID to the list.
Contact your language coordinator, email the i18n mailling list,
or submit a patch to add your ID by yourself.
.. TODO (amotoki):
We need a guide for language coordinators.
A Coordinator is recommended to update the translator list
when he/she adds a new member to his/her language team.
I hope someone adds a content.
If your Zanata ID is different from your launchpad ID,
Stackalytics will not find your translation statistics.
You need to let Stackalytics know your ID mappings.
To do this, you need to add your user data into ``etc/detault_data.json``
in `the Stackalytics repository <http://git.openstack.org/cgit/openstack/stackalytics/>`__.
An example is https://review.openstack.org/#/c/284638/1/etc/default_data.json.
@ -44,8 +60,3 @@ An example is https://review.openstack.org/#/c/284638/1/etc/default_data.json.
If you are lucky to use a same name for launchpad and Zanata IDs,
you do not need to do the above.
Stackalytics will find your statistics automatically.
Also, since Stackalytics uses the `translator list
<http://git.openstack.org/cgit/openstack/i18n/tree/tools/zanata/translation_team.yaml>`_
as of now, if you cannot find your name or ID in Stackalytics, please email
I18n mailing list, or submit a update patch to add your ID by yourself.