diff --git a/doc/source/translation_stats.rst b/doc/source/translation_stats.rst index 09742af..a452e4e 100644 --- a/doc/source/translation_stats.rst +++ b/doc/source/translation_stats.rst @@ -27,16 +27,32 @@ It supports translation statistics :) Visit `Stackalytics `__ 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 + `__? +* 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 `__. 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 -`_ -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.