)]}'
{"doc/source/devref/contribute.rst":[{"author":{"_account_id":14605,"name":"vikram.choudhary","email":"vikschw@gmail.com","username":"vikram.choudhary"},"change_message_id":"cfb190b9328bb415810db17292d1d5f4f8088bed","unresolved":false,"context_lines":[{"line_number":328,"context_line":"  \u003chttp://docs.openstack.org/infra/system-config/third_party.html\u003e`_ to get"},{"line_number":329,"context_line":"  one."},{"line_number":330,"context_line":""},{"line_number":331,"context_line":"I18n support"},{"line_number":332,"context_line":"------------"},{"line_number":333,"context_line":""},{"line_number":334,"context_line":"This section describes how to set up translation support."}],"source_content_type":"text/x-rst","patch_set":6,"id":"9a8ffd7b_5ab3134d","line":331,"updated":"2015-11-30 10:32:23.000000000","message":"Word about i18n would be useful. \"https://en.wikipedia.org/wiki/Internationalization_and_localization\"","commit_id":"497afc965fb7721c5b26a58b7f2c86fce553b354"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"c4b590c53d895b1b39e51be41c1ae6d374408a27","unresolved":false,"context_lines":[{"line_number":328,"context_line":"  \u003chttp://docs.openstack.org/infra/system-config/third_party.html\u003e`_ to get"},{"line_number":329,"context_line":"  one."},{"line_number":330,"context_line":""},{"line_number":331,"context_line":"I18n support"},{"line_number":332,"context_line":"------------"},{"line_number":333,"context_line":""},{"line_number":334,"context_line":"This section describes how to set up translation support."}],"source_content_type":"text/x-rst","patch_set":6,"id":"9a8ffd7b_e84a0e27","line":331,"in_reply_to":"9a8ffd7b_5ab3134d","updated":"2015-12-01 06:32:08.000000000","message":"Done. I added some words.","commit_id":"497afc965fb7721c5b26a58b7f2c86fce553b354"},{"author":{"_account_id":6854,"name":"YAMAMOTO Takashi","email":"yamamoto@midokura.com","username":"yamamoto"},"change_message_id":"28dae3952caf1890821627a8fb15a1119dba0fc0","unresolved":false,"context_lines":[{"line_number":349,"context_line":"     **DOMAIN** name should match your **repository** name ``${REPOSITORY}``."},{"line_number":350,"context_line":"     (Note that it is not a top level python path name ``${MODULE_NAME}``.)"},{"line_number":351,"context_line":""},{"line_number":352,"context_line":"* Import ``_()`` from your ``${MODULE_NAME}._i18n.py``."},{"line_number":353,"context_line":""},{"line_number":354,"context_line":"  .. warning::"},{"line_number":355,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"9a8ffd7b_f9d2195b","line":352,"updated":"2015-11-30 09:40:00.000000000","message":"${MODULE_NAME}/_i18n.py\n\n(use / for delimiter)","commit_id":"497afc965fb7721c5b26a58b7f2c86fce553b354"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"c4b590c53d895b1b39e51be41c1ae6d374408a27","unresolved":false,"context_lines":[{"line_number":349,"context_line":"     **DOMAIN** name should match your **repository** name ``${REPOSITORY}``."},{"line_number":350,"context_line":"     (Note that it is not a top level python path name ``${MODULE_NAME}``.)"},{"line_number":351,"context_line":""},{"line_number":352,"context_line":"* Import ``_()`` from your ``${MODULE_NAME}._i18n.py``."},{"line_number":353,"context_line":""},{"line_number":354,"context_line":"  .. warning::"},{"line_number":355,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"9a8ffd7b_685dbeeb","line":352,"in_reply_to":"9a8ffd7b_f9d2195b","updated":"2015-12-01 06:32:08.000000000","message":"Done","commit_id":"497afc965fb7721c5b26a58b7f2c86fce553b354"},{"author":{"_account_id":6854,"name":"YAMAMOTO Takashi","email":"yamamoto@midokura.com","username":"yamamoto"},"change_message_id":"28dae3952caf1890821627a8fb15a1119dba0fc0","unresolved":false,"context_lines":[{"line_number":353,"context_line":""},{"line_number":354,"context_line":"  .. warning::"},{"line_number":355,"context_line":""},{"line_number":356,"context_line":"     Do not use ``_()`` without importing ``${MODULE_NAME}._i18n.py``."},{"line_number":357,"context_line":"     This means you use ``_()`` in the builtins namespace which is"},{"line_number":358,"context_line":"     registered by **gettext.install()** in ``neutron/__init__.py``."},{"line_number":359,"context_line":"     It is now deprecated as described in oslo.18n documentation."}],"source_content_type":"text/x-rst","patch_set":6,"id":"9a8ffd7b_79c70996","line":356,"range":{"start_line":356,"start_character":44,"end_line":356,"end_character":68},"updated":"2015-11-30 09:40:00.000000000","message":"ditto","commit_id":"497afc965fb7721c5b26a58b7f2c86fce553b354"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"c4b590c53d895b1b39e51be41c1ae6d374408a27","unresolved":false,"context_lines":[{"line_number":353,"context_line":""},{"line_number":354,"context_line":"  .. warning::"},{"line_number":355,"context_line":""},{"line_number":356,"context_line":"     Do not use ``_()`` without importing ``${MODULE_NAME}._i18n.py``."},{"line_number":357,"context_line":"     This means you use ``_()`` in the builtins namespace which is"},{"line_number":358,"context_line":"     registered by **gettext.install()** in ``neutron/__init__.py``."},{"line_number":359,"context_line":"     It is now deprecated as described in oslo.18n documentation."}],"source_content_type":"text/x-rst","patch_set":6,"id":"9a8ffd7b_8a481ace","line":356,"range":{"start_line":356,"start_character":44,"end_line":356,"end_character":68},"in_reply_to":"9a8ffd7b_79c70996","updated":"2015-12-01 06:32:08.000000000","message":"Done","commit_id":"497afc965fb7721c5b26a58b7f2c86fce553b354"},{"author":{"_account_id":14605,"name":"vikram.choudhary","email":"vikschw@gmail.com","username":"vikram.choudhary"},"change_message_id":"cfb190b9328bb415810db17292d1d5f4f8088bed","unresolved":false,"context_lines":[{"line_number":386,"context_line":"    output_dir \u003d ${REPOSITORY}/locale"},{"line_number":387,"context_line":"    input_file \u003d ${REPOSITORY}/locale/${REPOSITORY}.pot"},{"line_number":388,"context_line":""},{"line_number":389,"context_line":"Note that not ``${MODULE_NAME}`` but ``${REPOSITORY}`` is used"},{"line_number":390,"context_line":"in all names. Both come from the implementation of the current infra"},{"line_number":391,"context_line":"scripts. Changing it affects many projects, so it is not a good idea."},{"line_number":392,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"9a8ffd7b_ba56bfcb","line":389,"updated":"2015-11-30 10:32:23.000000000","message":"IMO, \u0027not ``${MODULE_NAME}`` but\u0027 is not required.","commit_id":"497afc965fb7721c5b26a58b7f2c86fce553b354"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"c4b590c53d895b1b39e51be41c1ae6d374408a27","unresolved":false,"context_lines":[{"line_number":386,"context_line":"    output_dir \u003d ${REPOSITORY}/locale"},{"line_number":387,"context_line":"    input_file \u003d ${REPOSITORY}/locale/${REPOSITORY}.pot"},{"line_number":388,"context_line":""},{"line_number":389,"context_line":"Note that not ``${MODULE_NAME}`` but ``${REPOSITORY}`` is used"},{"line_number":390,"context_line":"in all names. Both come from the implementation of the current infra"},{"line_number":391,"context_line":"scripts. Changing it affects many projects, so it is not a good idea."},{"line_number":392,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"9a8ffd7b_0a342a48","line":389,"in_reply_to":"9a8ffd7b_ba56bfcb","updated":"2015-12-01 06:32:08.000000000","message":"Done","commit_id":"497afc965fb7721c5b26a58b7f2c86fce553b354"},{"author":{"_account_id":9656,"name":"Ihar Hrachyshka","email":"ihrachys@redhat.com","username":"ihrachys","status":"Red Hat Networking Systems Engineer"},"change_message_id":"b1757f81cdc5aa4f1104aa774f27d0eb9ff6da09","unresolved":false,"context_lines":[{"line_number":396,"context_line":""},{"line_number":397,"context_line":"Finally, create a skeleton POT file."},{"line_number":398,"context_line":"To import translation, we need to place it at the proper place."},{"line_number":399,"context_line":"Run the following command lines in the top directory of your repository::"},{"line_number":400,"context_line":""},{"line_number":401,"context_line":"  $ mkdir -p ${REPOSITORY}/locale"},{"line_number":402,"context_line":"  $ tox -e venv -- python setup.py extract_messages"}],"source_content_type":"text/x-rst","patch_set":6,"id":"9a8ffd7b_a208c32e","line":399,"updated":"2015-11-30 16:31:30.000000000","message":"command lines -\u003e commands","commit_id":"497afc965fb7721c5b26a58b7f2c86fce553b354"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"c4b590c53d895b1b39e51be41c1ae6d374408a27","unresolved":false,"context_lines":[{"line_number":396,"context_line":""},{"line_number":397,"context_line":"Finally, create a skeleton POT file."},{"line_number":398,"context_line":"To import translation, we need to place it at the proper place."},{"line_number":399,"context_line":"Run the following command lines in the top directory of your repository::"},{"line_number":400,"context_line":""},{"line_number":401,"context_line":"  $ mkdir -p ${REPOSITORY}/locale"},{"line_number":402,"context_line":"  $ tox -e venv -- python setup.py extract_messages"}],"source_content_type":"text/x-rst","patch_set":6,"id":"9a8ffd7b_ea3be636","line":399,"in_reply_to":"9a8ffd7b_a208c32e","updated":"2015-12-01 06:32:08.000000000","message":"Done","commit_id":"497afc965fb7721c5b26a58b7f2c86fce553b354"},{"author":{"_account_id":6659,"name":"Paul Michali","email":"pc@michali.net","username":"pcm"},"change_message_id":"4bd7e5474687992d057d86ddb838f7d7094f6fa7","unresolved":false,"context_lines":[{"line_number":328,"context_line":"  \u003chttp://docs.openstack.org/infra/system-config/third_party.html\u003e`_ to get"},{"line_number":329,"context_line":"  one."},{"line_number":330,"context_line":""},{"line_number":331,"context_line":"I18n (Internationalizatin) support"},{"line_number":332,"context_line":"----------------------------------"},{"line_number":333,"context_line":""},{"line_number":334,"context_line":"OpenStack is committed to broad international support."}],"source_content_type":"text/x-rst","patch_set":7,"id":"9a8ffd7b_eb4af6ab","line":331,"updated":"2015-12-01 12:35:55.000000000","message":"nit: Internationalization (missing o)\n\nWould say... \"Internationalization support\" and define abbreviation in body.","commit_id":"1986d98f7451bfc80955be03e134550ef6f349a0"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"b3d3de16a9bc0a698ad7af9c1a58038c36c76dec","unresolved":false,"context_lines":[{"line_number":328,"context_line":"  \u003chttp://docs.openstack.org/infra/system-config/third_party.html\u003e`_ to get"},{"line_number":329,"context_line":"  one."},{"line_number":330,"context_line":""},{"line_number":331,"context_line":"I18n (Internationalizatin) support"},{"line_number":332,"context_line":"----------------------------------"},{"line_number":333,"context_line":""},{"line_number":334,"context_line":"OpenStack is committed to broad international support."}],"source_content_type":"text/x-rst","patch_set":7,"id":"9a8ffd7b_34a256fd","line":331,"in_reply_to":"9a8ffd7b_eb4af6ab","updated":"2015-12-02 13:32:29.000000000","message":"Done","commit_id":"1986d98f7451bfc80955be03e134550ef6f349a0"},{"author":{"_account_id":6659,"name":"Paul Michali","email":"pc@michali.net","username":"pcm"},"change_message_id":"4bd7e5474687992d057d86ddb838f7d7094f6fa7","unresolved":false,"context_lines":[{"line_number":332,"context_line":"----------------------------------"},{"line_number":333,"context_line":""},{"line_number":334,"context_line":"OpenStack is committed to broad international support."},{"line_number":335,"context_line":"I18n (Internationalizatin) is one of important areas to make OpenStack ubiquitous."},{"line_number":336,"context_line":"Each project is recommended to support I18n."},{"line_number":337,"context_line":""},{"line_number":338,"context_line":"This section describes how to set up translation support."}],"source_content_type":"text/x-rst","patch_set":7,"id":"9a8ffd7b_6bd5a6b7","line":335,"updated":"2015-12-01 12:35:55.000000000","message":"Internationalization (i18n)...","commit_id":"1986d98f7451bfc80955be03e134550ef6f349a0"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"b3d3de16a9bc0a698ad7af9c1a58038c36c76dec","unresolved":false,"context_lines":[{"line_number":332,"context_line":"----------------------------------"},{"line_number":333,"context_line":""},{"line_number":334,"context_line":"OpenStack is committed to broad international support."},{"line_number":335,"context_line":"I18n (Internationalizatin) is one of important areas to make OpenStack ubiquitous."},{"line_number":336,"context_line":"Each project is recommended to support I18n."},{"line_number":337,"context_line":""},{"line_number":338,"context_line":"This section describes how to set up translation support."}],"source_content_type":"text/x-rst","patch_set":7,"id":"9a8ffd7b_3479f682","line":335,"in_reply_to":"9a8ffd7b_6bd5a6b7","updated":"2015-12-02 13:32:29.000000000","message":"Done","commit_id":"1986d98f7451bfc80955be03e134550ef6f349a0"},{"author":{"_account_id":6659,"name":"Paul Michali","email":"pc@michali.net","username":"pcm"},"change_message_id":"4bd7e5474687992d057d86ddb838f7d7094f6fa7","unresolved":false,"context_lines":[{"line_number":333,"context_line":""},{"line_number":334,"context_line":"OpenStack is committed to broad international support."},{"line_number":335,"context_line":"I18n (Internationalizatin) is one of important areas to make OpenStack ubiquitous."},{"line_number":336,"context_line":"Each project is recommended to support I18n."},{"line_number":337,"context_line":""},{"line_number":338,"context_line":"This section describes how to set up translation support."},{"line_number":339,"context_line":"The description in this section uses the following variables."}],"source_content_type":"text/x-rst","patch_set":7,"id":"9a8ffd7b_cbe4d2ad","line":336,"updated":"2015-12-01 12:35:55.000000000","message":"nit: i18n","commit_id":"1986d98f7451bfc80955be03e134550ef6f349a0"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"b3d3de16a9bc0a698ad7af9c1a58038c36c76dec","unresolved":false,"context_lines":[{"line_number":333,"context_line":""},{"line_number":334,"context_line":"OpenStack is committed to broad international support."},{"line_number":335,"context_line":"I18n (Internationalizatin) is one of important areas to make OpenStack ubiquitous."},{"line_number":336,"context_line":"Each project is recommended to support I18n."},{"line_number":337,"context_line":""},{"line_number":338,"context_line":"This section describes how to set up translation support."},{"line_number":339,"context_line":"The description in this section uses the following variables."}],"source_content_type":"text/x-rst","patch_set":7,"id":"9a8ffd7b_d48aea63","line":336,"in_reply_to":"9a8ffd7b_cbe4d2ad","updated":"2015-12-02 13:32:29.000000000","message":"Done","commit_id":"1986d98f7451bfc80955be03e134550ef6f349a0"},{"author":{"_account_id":9656,"name":"Ihar Hrachyshka","email":"ihrachys@redhat.com","username":"ihrachys","status":"Red Hat Networking Systems Engineer"},"change_message_id":"9955b13a0ebf22cee5db5d51c3221847586ca0c1","unresolved":false,"context_lines":[{"line_number":357,"context_line":""},{"line_number":358,"context_line":"  .. warning::"},{"line_number":359,"context_line":""},{"line_number":360,"context_line":"     Do not use ``_()`` without importing ``${MODULE_NAME}/_i18n.py``."},{"line_number":361,"context_line":"     This means you use ``_()`` in the builtins namespace which is"},{"line_number":362,"context_line":"     registered by **gettext.install()** in ``neutron/__init__.py``."},{"line_number":363,"context_line":"     It is now deprecated as described in oslo.18n documentation."}],"source_content_type":"text/x-rst","patch_set":7,"id":"9a8ffd7b_c804c1c7","line":360,"updated":"2015-12-01 17:29:31.000000000","message":"actually not \u0027without importing\u0027 but \u0027outside of\u0027","commit_id":"1986d98f7451bfc80955be03e134550ef6f349a0"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"b3d3de16a9bc0a698ad7af9c1a58038c36c76dec","unresolved":false,"context_lines":[{"line_number":357,"context_line":""},{"line_number":358,"context_line":"  .. warning::"},{"line_number":359,"context_line":""},{"line_number":360,"context_line":"     Do not use ``_()`` without importing ``${MODULE_NAME}/_i18n.py``."},{"line_number":361,"context_line":"     This means you use ``_()`` in the builtins namespace which is"},{"line_number":362,"context_line":"     registered by **gettext.install()** in ``neutron/__init__.py``."},{"line_number":363,"context_line":"     It is now deprecated as described in oslo.18n documentation."}],"source_content_type":"text/x-rst","patch_set":7,"id":"9a8ffd7b_340c96eb","line":360,"in_reply_to":"9a8ffd7b_c804c1c7","updated":"2015-12-02 13:32:29.000000000","message":"What I would like to say here is that we should not use _() from the builtins namespace. The current version seems confusing as you felt so. I need to rephrase it.","commit_id":"1986d98f7451bfc80955be03e134550ef6f349a0"},{"author":{"_account_id":6659,"name":"Paul Michali","email":"pc@michali.net","username":"pcm"},"change_message_id":"799a6b4893a2c9efa3cb1b0cf508addab31f87c4","unresolved":false,"context_lines":[{"line_number":332,"context_line":"----------------------------"},{"line_number":333,"context_line":""},{"line_number":334,"context_line":"OpenStack is committed to broad international support."},{"line_number":335,"context_line":"Internationalization (I18n) is one of important areas to make OpenStack ubiquitous."},{"line_number":336,"context_line":"Each project is recommended to support i18n."},{"line_number":337,"context_line":""},{"line_number":338,"context_line":"This section describes how to set up translation support."}],"source_content_type":"text/x-rst","patch_set":8,"id":"9a8ffd7b_118e3ad0","line":335,"updated":"2015-12-02 15:32:43.000000000","message":"nit: I18n -\u003e i18n","commit_id":"bd36baf3ecfa10c7b8e1e012980feacc605d57e4"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"d3389e046d356fdf66148e66f44eef46716b9253","unresolved":false,"context_lines":[{"line_number":332,"context_line":"----------------------------"},{"line_number":333,"context_line":""},{"line_number":334,"context_line":"OpenStack is committed to broad international support."},{"line_number":335,"context_line":"Internationalization (I18n) is one of important areas to make OpenStack ubiquitous."},{"line_number":336,"context_line":"Each project is recommended to support i18n."},{"line_number":337,"context_line":""},{"line_number":338,"context_line":"This section describes how to set up translation support."}],"source_content_type":"text/x-rst","patch_set":8,"id":"9a8ffd7b_f095a732","line":335,"in_reply_to":"9a8ffd7b_118e3ad0","updated":"2015-12-02 17:37:46.000000000","message":"I thought \u0027I18n\u0027 is an abbrev of Internationalization, so I used the capitalized version. Is it better to use non-capitalized version for a string inside parentheses?","commit_id":"bd36baf3ecfa10c7b8e1e012980feacc605d57e4"},{"author":{"_account_id":9656,"name":"Ihar Hrachyshka","email":"ihrachys@redhat.com","username":"ihrachys","status":"Red Hat Networking Systems Engineer"},"change_message_id":"9a8d895163586b7c2a4fdb8ad4357d302b6501a4","unresolved":false,"context_lines":[{"line_number":332,"context_line":"----------------------------"},{"line_number":333,"context_line":""},{"line_number":334,"context_line":"OpenStack is committed to broad international support."},{"line_number":335,"context_line":"Internationalization (I18n) is one of important areas to make OpenStack ubiquitous."},{"line_number":336,"context_line":"Each project is recommended to support i18n."},{"line_number":337,"context_line":""},{"line_number":338,"context_line":"This section describes how to set up translation support."}],"source_content_type":"text/x-rst","patch_set":8,"id":"9a8ffd7b_7fa8a08c","line":335,"in_reply_to":"9a8ffd7b_f095a732","updated":"2015-12-02 19:03:54.000000000","message":"it\u0027s usually all lower case for both l10n and i18n. But meh.","commit_id":"bd36baf3ecfa10c7b8e1e012980feacc605d57e4"}],"doc/source/stadium/sub_project_repo.rst":[{"author":{"_account_id":1653,"name":"garyk","email":"gkotton@vmware.com","username":"garyk"},"change_message_id":"8f2f4ed1201bdb0f1a8540e5fa9716061c897167","unresolved":false,"context_lines":[{"line_number":24,"context_line":"Sub-Project Repository Guide"},{"line_number":25,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"This document describes various thing around subproject repository setup."},{"line_number":28,"context_line":""},{"line_number":29,"context_line":"More contents will be appreciated."},{"line_number":30,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"9a8ffd7b_b767234c","line":27,"updated":"2015-11-26 13:31:07.000000000","message":"thing \u003d\u003e things","commit_id":"b280d11ce73cd4ffaf629cbfd76882af212decdc"},{"author":{"_account_id":1653,"name":"garyk","email":"gkotton@vmware.com","username":"garyk"},"change_message_id":"8f2f4ed1201bdb0f1a8540e5fa9716061c897167","unresolved":false,"context_lines":[{"line_number":109,"context_line":""},{"line_number":110,"context_line":"This step is optional."},{"line_number":111,"context_line":""},{"line_number":112,"context_line":"To upadte/import translations, you need to make a change in project-config."},{"line_number":113,"context_line":"A good example is found at https://review.openstack.org/#/c/224222/."},{"line_number":114,"context_line":"After doing this, the necessary jobs will be run and push/pull a"},{"line_number":115,"context_line":"message catalog to/from the translation infrastructure."}],"source_content_type":"text/x-rst","patch_set":3,"id":"9a8ffd7b_57e6f7b0","line":112,"updated":"2015-11-26 13:31:07.000000000","message":"upadte \u003d\u003e update","commit_id":"b280d11ce73cd4ffaf629cbfd76882af212decdc"},{"author":{"_account_id":6659,"name":"Paul Michali","email":"pc@michali.net","username":"pcm"},"change_message_id":"c0a39db26507fe9f26ad4fdd24d6de946d846aa5","unresolved":false,"context_lines":[{"line_number":40,"context_line":"~~~~~~~~~"},{"line_number":41,"context_line":""},{"line_number":42,"context_line":"* Each subproject repository should have its own oslo.i18n integration"},{"line_number":43,"context_line":"  wrapper module ``${MODULE_NAME}._i18n.py``. The detail is found at"},{"line_number":44,"context_line":"  http://docs.openstack.org/developer/oslo.i18n/usage.html."},{"line_number":45,"context_line":""},{"line_number":46,"context_line":"  .. note::"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9a8ffd7b_652d57a7","line":43,"updated":"2015-11-27 13:01:48.000000000","message":"Is this so that each project has its own translations (versus have this wrapper in neutron-lib)?","commit_id":"98c60076a08b59f40ea263a7d499cb2adca15f61"},{"author":{"_account_id":6854,"name":"YAMAMOTO Takashi","email":"yamamoto@midokura.com","username":"yamamoto"},"change_message_id":"71bb6c0b48d88d8979172f36fb53618046f5f2ea","unresolved":false,"context_lines":[{"line_number":40,"context_line":"~~~~~~~~~"},{"line_number":41,"context_line":""},{"line_number":42,"context_line":"* Each subproject repository should have its own oslo.i18n integration"},{"line_number":43,"context_line":"  wrapper module ``${MODULE_NAME}._i18n.py``. The detail is found at"},{"line_number":44,"context_line":"  http://docs.openstack.org/developer/oslo.i18n/usage.html."},{"line_number":45,"context_line":""},{"line_number":46,"context_line":"  .. note::"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9a8ffd7b_dd4df3c4","line":43,"range":{"start_line":43,"start_character":19,"end_line":43,"end_character":42},"updated":"2015-11-27 14:10:23.000000000","message":"this should be\n${MODULE_NAME}._i18n\nor\n${MODULE_NAME}/_i18n.py","commit_id":"98c60076a08b59f40ea263a7d499cb2adca15f61"},{"author":{"_account_id":9656,"name":"Ihar Hrachyshka","email":"ihrachys@redhat.com","username":"ihrachys","status":"Red Hat Networking Systems Engineer"},"change_message_id":"2fb8960b4bfb9b01968e8a65129bf8c14d2ae8af","unresolved":false,"context_lines":[{"line_number":40,"context_line":"~~~~~~~~~"},{"line_number":41,"context_line":""},{"line_number":42,"context_line":"* Each subproject repository should have its own oslo.i18n integration"},{"line_number":43,"context_line":"  wrapper module ``${MODULE_NAME}._i18n.py``. The detail is found at"},{"line_number":44,"context_line":"  http://docs.openstack.org/developer/oslo.i18n/usage.html."},{"line_number":45,"context_line":""},{"line_number":46,"context_line":"  .. note::"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9a8ffd7b_8ce3b1d8","line":43,"in_reply_to":"9a8ffd7b_11e04495","updated":"2015-11-27 20:36:51.000000000","message":"I don\u0027t believe there is a way to detect the __import__ caller from inside imported module.\n\nThat said, neutron-lib i18n module could receive the name of the domain as an argument.","commit_id":"98c60076a08b59f40ea263a7d499cb2adca15f61"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"d6d221a8e5dd1588fd7255807dcdce767f186d76","unresolved":false,"context_lines":[{"line_number":40,"context_line":"~~~~~~~~~"},{"line_number":41,"context_line":""},{"line_number":42,"context_line":"* Each subproject repository should have its own oslo.i18n integration"},{"line_number":43,"context_line":"  wrapper module ``${MODULE_NAME}._i18n.py``. The detail is found at"},{"line_number":44,"context_line":"  http://docs.openstack.org/developer/oslo.i18n/usage.html."},{"line_number":45,"context_line":""},{"line_number":46,"context_line":"  .. note::"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9a8ffd7b_11e04495","line":43,"in_reply_to":"9a8ffd7b_652d57a7","updated":"2015-11-27 15:17:15.000000000","message":"Yes it means each project has its own translations.\n\nI am open to the final direction. The following is my current understanding.\n\nA translation domain is defined in _i18n.py. The domain is used to determine the PO filename. In a straightforward way, if we share a wrapper from neutron-lib, neutron-lib or neutron repo has a single POT file which contains all strings from all neutron sub-projects.\nIMO this does not scale.\n\nIf neutron-lib i18n.py have a way to switch a translation \u0027domain\u0027 depending on which project imports i18n.py, we can share i18n.py in neutron-lib.\n\nThought?","commit_id":"98c60076a08b59f40ea263a7d499cb2adca15f61"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"e63685ef2f09788ce81237012d79656e6a4bb7f7","unresolved":false,"context_lines":[{"line_number":40,"context_line":"~~~~~~~~~"},{"line_number":41,"context_line":""},{"line_number":42,"context_line":"* Each subproject repository should have its own oslo.i18n integration"},{"line_number":43,"context_line":"  wrapper module ``${MODULE_NAME}._i18n.py``. The detail is found at"},{"line_number":44,"context_line":"  http://docs.openstack.org/developer/oslo.i18n/usage.html."},{"line_number":45,"context_line":""},{"line_number":46,"context_line":"  .. note::"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9a8ffd7b_cf29ab9c","line":43,"in_reply_to":"9a8ffd7b_8ce3b1d8","updated":"2015-11-27 21:47:29.000000000","message":"All object exposed by _i18n wrapper module is from\n\n  _translators \u003d oslo_i18n.TranslatorFactory(domain\u003d\u0027neutron\u0027)\n\nso I don\u0027t think sharing _i18n.py in neutron-lib works.","commit_id":"98c60076a08b59f40ea263a7d499cb2adca15f61"},{"author":{"_account_id":6854,"name":"YAMAMOTO Takashi","email":"yamamoto@midokura.com","username":"yamamoto"},"change_message_id":"71bb6c0b48d88d8979172f36fb53618046f5f2ea","unresolved":false,"context_lines":[{"line_number":54,"context_line":""},{"line_number":55,"context_line":"     Do not use ``_()`` without importing ``${MODULE_NAME}._i18n.py``."},{"line_number":56,"context_line":"     This means you use ``_()`` in the builtins namespace which is"},{"line_number":57,"context_line":"     registered by **gettext.install()** in ``neutron/__init__/py``."},{"line_number":58,"context_line":"     It is now deprecated as described in oslo.18n documentation."},{"line_number":59,"context_line":""},{"line_number":60,"context_line":"Setting up translation support"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9a8ffd7b_1d061b52","line":57,"range":{"start_line":57,"start_character":54,"end_line":57,"end_character":65},"updated":"2015-11-27 14:10:23.000000000","message":"__init__.py","commit_id":"98c60076a08b59f40ea263a7d499cb2adca15f61"},{"author":{"_account_id":9656,"name":"Ihar Hrachyshka","email":"ihrachys@redhat.com","username":"ihrachys","status":"Red Hat Networking Systems Engineer"},"change_message_id":"2fb8960b4bfb9b01968e8a65129bf8c14d2ae8af","unresolved":false,"context_lines":[{"line_number":55,"context_line":"     Do not use ``_()`` without importing ``${MODULE_NAME}._i18n.py``."},{"line_number":56,"context_line":"     This means you use ``_()`` in the builtins namespace which is"},{"line_number":57,"context_line":"     registered by **gettext.install()** in ``neutron/__init__/py``."},{"line_number":58,"context_line":"     It is now deprecated as described in oslo.18n documentation."},{"line_number":59,"context_line":""},{"line_number":60,"context_line":"Setting up translation support"},{"line_number":61,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9a8ffd7b_6cca0d1d","line":58,"updated":"2015-11-27 20:36:51.000000000","message":"I think we should also emit deprecation warnings when it\u0027s used: https://review.openstack.org/250946","commit_id":"98c60076a08b59f40ea263a7d499cb2adca15f61"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"e63685ef2f09788ce81237012d79656e6a4bb7f7","unresolved":false,"context_lines":[{"line_number":55,"context_line":"     Do not use ``_()`` without importing ``${MODULE_NAME}._i18n.py``."},{"line_number":56,"context_line":"     This means you use ``_()`` in the builtins namespace which is"},{"line_number":57,"context_line":"     registered by **gettext.install()** in ``neutron/__init__/py``."},{"line_number":58,"context_line":"     It is now deprecated as described in oslo.18n documentation."},{"line_number":59,"context_line":""},{"line_number":60,"context_line":"Setting up translation support"},{"line_number":61,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9a8ffd7b_2f11575d","line":58,"in_reply_to":"9a8ffd7b_6cca0d1d","updated":"2015-11-27 21:47:29.000000000","message":"That\u0027s a good idea. I thought it but I haven\u0027t figured out how we can. Thanks.","commit_id":"98c60076a08b59f40ea263a7d499cb2adca15f61"},{"author":{"_account_id":9656,"name":"Ihar Hrachyshka","email":"ihrachys@redhat.com","username":"ihrachys","status":"Red Hat Networking Systems Engineer"},"change_message_id":"2fb8960b4bfb9b01968e8a65129bf8c14d2ae8af","unresolved":false,"context_lines":[{"line_number":60,"context_line":"Setting up translation support"},{"line_number":61,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":62,"context_line":""},{"line_number":63,"context_line":"This step is optional and is required when your project support translations."},{"line_number":64,"context_line":""},{"line_number":65,"context_line":"You need to create or edit the following files to start translation support:"},{"line_number":66,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"9a8ffd7b_cf2e8b8b","line":63,"updated":"2015-11-27 20:36:51.000000000","message":"supports\n\nIs it the only step optional? I believe that if projects do not want to have translations, they may as well skip all starting from line 36.","commit_id":"98c60076a08b59f40ea263a7d499cb2adca15f61"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"e63685ef2f09788ce81237012d79656e6a4bb7f7","unresolved":false,"context_lines":[{"line_number":60,"context_line":"Setting up translation support"},{"line_number":61,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":62,"context_line":""},{"line_number":63,"context_line":"This step is optional and is required when your project support translations."},{"line_number":64,"context_line":""},{"line_number":65,"context_line":"You need to create or edit the following files to start translation support:"},{"line_number":66,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"9a8ffd7b_ef0fcf34","line":63,"in_reply_to":"9a8ffd7b_cf2e8b8b","updated":"2015-11-27 21:47:29.000000000","message":"Ah.. it\u0027s confusing and you are right. What in my mind when I wrote it is it can be deferred. I need to reword or remove it.","commit_id":"98c60076a08b59f40ea263a7d499cb2adca15f61"},{"author":{"_account_id":9656,"name":"Ihar Hrachyshka","email":"ihrachys@redhat.com","username":"ihrachys","status":"Red Hat Networking Systems Engineer"},"change_message_id":"2fb8960b4bfb9b01968e8a65129bf8c14d2ae8af","unresolved":false,"context_lines":[{"line_number":74,"context_line":"Add the following to ``setup.cfg``::"},{"line_number":75,"context_line":""},{"line_number":76,"context_line":"    [extract_messages]"},{"line_number":77,"context_line":"    keywords \u003d _ gettext ngettext l_ lazy_gettext"},{"line_number":78,"context_line":"    mapping_file \u003d babel.cfg"},{"line_number":79,"context_line":"    output_file \u003d ${REPOSITORY}/locale/${REPOSITORY}.pot"},{"line_number":80,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"9a8ffd7b_4f593b34","line":77,"updated":"2015-11-27 20:36:51.000000000","message":"So it\u0027s still that _ marker? Should we discourage using it?","commit_id":"98c60076a08b59f40ea263a7d499cb2adca15f61"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"e63685ef2f09788ce81237012d79656e6a4bb7f7","unresolved":false,"context_lines":[{"line_number":74,"context_line":"Add the following to ``setup.cfg``::"},{"line_number":75,"context_line":""},{"line_number":76,"context_line":"    [extract_messages]"},{"line_number":77,"context_line":"    keywords \u003d _ gettext ngettext l_ lazy_gettext"},{"line_number":78,"context_line":"    mapping_file \u003d babel.cfg"},{"line_number":79,"context_line":"    output_file \u003d ${REPOSITORY}/locale/${REPOSITORY}.pot"},{"line_number":80,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"9a8ffd7b_cf00cb04","line":77,"in_reply_to":"9a8ffd7b_4f593b34","updated":"2015-11-27 21:47:29.000000000","message":"We don\u0027t discourage the use of _. We are just discouraging to consume _ from the python builtins namespace.","commit_id":"98c60076a08b59f40ea263a7d499cb2adca15f61"},{"author":{"_account_id":9656,"name":"Ihar Hrachyshka","email":"ihrachys@redhat.com","username":"ihrachys","status":"Red Hat Networking Systems Engineer"},"change_message_id":"2fb8960b4bfb9b01968e8a65129bf8c14d2ae8af","unresolved":false,"context_lines":[{"line_number":85,"context_line":"    [update_catalog]"},{"line_number":86,"context_line":"    domain \u003d ${REPOSITORY}"},{"line_number":87,"context_line":"    output_dir \u003d ${REPOSITORY}/locale"},{"line_number":88,"context_line":"    input_file \u003d ${REPOSITORY}/locale/${REPOSITORY}.pot"},{"line_number":89,"context_line":""},{"line_number":90,"context_line":"Note that not ``${MODULE_NAME}}`` but ``${REPOSITORY}`` is used"},{"line_number":91,"context_line":"in all names. Both come from the implementation of the current infra"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9a8ffd7b_6f775fa0","line":88,"updated":"2015-11-27 20:36:51.000000000","message":"My understanding is that each log level (_LI, _LW, ...) should have its own .pot/.po files. I don\u0027t see we set them up here.","commit_id":"98c60076a08b59f40ea263a7d499cb2adca15f61"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"e63685ef2f09788ce81237012d79656e6a4bb7f7","unresolved":false,"context_lines":[{"line_number":85,"context_line":"    [update_catalog]"},{"line_number":86,"context_line":"    domain \u003d ${REPOSITORY}"},{"line_number":87,"context_line":"    output_dir \u003d ${REPOSITORY}/locale"},{"line_number":88,"context_line":"    input_file \u003d ${REPOSITORY}/locale/${REPOSITORY}.pot"},{"line_number":89,"context_line":""},{"line_number":90,"context_line":"Note that not ``${MODULE_NAME}}`` but ``${REPOSITORY}`` is used"},{"line_number":91,"context_line":"in all names. Both come from the implementation of the current infra"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9a8ffd7b_522240a4","line":88,"in_reply_to":"9a8ffd7b_6f775fa0","updated":"2015-11-27 21:47:29.000000000","message":"Yes, we have. .pot files for each log level is automatically created by the infra script directly (extract_messages_log in [1]).\n\nOn the other hand, extract_message in [1] expects that the .pot file exists. This is the reason that L.103 is required.\nI think we can improve the infra script but it is what we have at the moment.\n\n[1] http://git.openstack.org/cgit/openstack-infra/project-config/tree/jenkins/scripts/common_translation_update.sh","commit_id":"98c60076a08b59f40ea263a7d499cb2adca15f61"},{"author":{"_account_id":6854,"name":"YAMAMOTO Takashi","email":"yamamoto@midokura.com","username":"yamamoto"},"change_message_id":"71bb6c0b48d88d8979172f36fb53618046f5f2ea","unresolved":false,"context_lines":[{"line_number":87,"context_line":"    output_dir \u003d ${REPOSITORY}/locale"},{"line_number":88,"context_line":"    input_file \u003d ${REPOSITORY}/locale/${REPOSITORY}.pot"},{"line_number":89,"context_line":""},{"line_number":90,"context_line":"Note that not ``${MODULE_NAME}}`` but ``${REPOSITORY}`` is used"},{"line_number":91,"context_line":"in all names. Both come from the implementation of the current infra"},{"line_number":92,"context_line":"scripts. Changing it affects many project, so it is not a good idea."},{"line_number":93,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"9a8ffd7b_5de6e3e8","line":90,"range":{"start_line":90,"start_character":30,"end_line":90,"end_character":31},"updated":"2015-11-27 14:10:23.000000000","message":"extra }","commit_id":"98c60076a08b59f40ea263a7d499cb2adca15f61"},{"author":{"_account_id":18573,"name":"Petri Kemppainen","email":"petri.kemppainen@nokia.com","username":"petrkemp"},"change_message_id":"f338bb02c68d02b9c406132bb4f7c048cc75204e","unresolved":false,"context_lines":[{"line_number":88,"context_line":"    input_file \u003d ${REPOSITORY}/locale/${REPOSITORY}.pot"},{"line_number":89,"context_line":""},{"line_number":90,"context_line":"Note that not ``${MODULE_NAME}}`` but ``${REPOSITORY}`` is used"},{"line_number":91,"context_line":"in all names. Both come from the implementation of the current infra"},{"line_number":92,"context_line":"scripts. Changing it affects many project, so it is not a good idea."},{"line_number":93,"context_line":""},{"line_number":94,"context_line":"Create ``babel.cfg`` with the following contents::"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9a8ffd7b_593360ab","line":91,"updated":"2015-11-27 11:41:07.000000000","message":"project--\u003eprojects","commit_id":"98c60076a08b59f40ea263a7d499cb2adca15f61"},{"author":{"_account_id":18573,"name":"Petri Kemppainen","email":"petri.kemppainen@nokia.com","username":"petrkemp"},"change_message_id":"f338bb02c68d02b9c406132bb4f7c048cc75204e","unresolved":false,"context_lines":[{"line_number":96,"context_line":"    [python: **.py]"},{"line_number":97,"context_line":""},{"line_number":98,"context_line":"Finally, create a skeleton POT file."},{"line_number":99,"context_line":"To import translation, we need to place it at the proper place."},{"line_number":100,"context_line":"Run the following command lines in the top directory of your repository::"},{"line_number":101,"context_line":""},{"line_number":102,"context_line":"  $ mkdir -p ${REPOSITORY}/locale"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9a8ffd7b_b997ec46","line":99,"updated":"2015-11-27 11:41:07.000000000","message":":: --\u003e :","commit_id":"98c60076a08b59f40ea263a7d499cb2adca15f61"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"d6d221a8e5dd1588fd7255807dcdce767f186d76","unresolved":false,"context_lines":[{"line_number":96,"context_line":"    [python: **.py]"},{"line_number":97,"context_line":""},{"line_number":98,"context_line":"Finally, create a skeleton POT file."},{"line_number":99,"context_line":"To import translation, we need to place it at the proper place."},{"line_number":100,"context_line":"Run the following command lines in the top directory of your repository::"},{"line_number":101,"context_line":""},{"line_number":102,"context_line":"  $ mkdir -p ${REPOSITORY}/locale"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9a8ffd7b_11a84476","line":99,"in_reply_to":"9a8ffd7b_b997ec46","updated":"2015-11-27 15:17:15.000000000","message":"It is intentional. It is a rest convention which means the beginning of the code block below.","commit_id":"98c60076a08b59f40ea263a7d499cb2adca15f61"},{"author":{"_account_id":6524,"name":"Henry Gessau","email":"HenryG@gessau.net","username":"gessau"},"change_message_id":"ef730d4959c722a9bad9c2597f0e11b6f51444fd","unresolved":false,"context_lines":[{"line_number":24,"context_line":"Sub-Project Repository Guide"},{"line_number":25,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"This document describes various things around subproject repository setup."},{"line_number":28,"context_line":""},{"line_number":29,"context_line":"More contents will be appreciated."},{"line_number":30,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a8ffd7b_83537c16","line":27,"updated":"2015-11-28 00:59:06.000000000","message":"I wonder if it might be better to add the \"I18n Support\" section to contribute.rst instead?","commit_id":"352f7a588c8c071ba5dfd302dc33fb1277c1810b"},{"author":{"_account_id":841,"name":"Akihiro Motoki","email":"amotoki@gmail.com","username":"amotoki"},"change_message_id":"4ad62fc969929b5d491ec85308bcaae72afd7258","unresolved":false,"context_lines":[{"line_number":24,"context_line":"Sub-Project Repository Guide"},{"line_number":25,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"This document describes various things around subproject repository setup."},{"line_number":28,"context_line":""},{"line_number":29,"context_line":"More contents will be appreciated."},{"line_number":30,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"9a8ffd7b_15b49d7d","line":27,"in_reply_to":"9a8ffd7b_83537c16","updated":"2015-11-29 04:17:28.000000000","message":"Done.\n\nWhen I looked at contribute.rst before, I thought it is a bit specifc to plugin/driver contributions, but after a second look the most part of the document except the plugin decomposition is generic to all subprojects. It sounds reasonable to move it to contribute.rst. Thanks!","commit_id":"352f7a588c8c071ba5dfd302dc33fb1277c1810b"}]}
