| *** _ianychoi_ is now known as ianychoi | 00:13 | |
| *** Daisy has joined #openstack-i18n | 01:17 | |
| *** Daisy has quit IRC | 01:19 | |
| *** Daisy has joined #openstack-i18n | 01:20 | |
| *** Daisy has quit IRC | 01:28 | |
| *** Daisy has joined #openstack-i18n | 01:34 | |
| *** Daisy has quit IRC | 01:39 | |
| *** Daisy has joined #openstack-i18n | 02:02 | |
| *** Daisy has quit IRC | 02:09 | |
| *** Daisy has joined #openstack-i18n | 02:09 | |
| *** Daisy has quit IRC | 02:14 | |
| *** Daisy has joined #openstack-i18n | 02:28 | |
| *** Daisy has quit IRC | 02:42 | |
| *** Daisy has joined #openstack-i18n | 03:04 | |
| *** Daisy has quit IRC | 03:08 | |
| *** Daisy has joined #openstack-i18n | 03:32 | |
| *** Daisy has quit IRC | 03:37 | |
| *** Daisy has joined #openstack-i18n | 03:54 | |
| *** Daisy has quit IRC | 03:57 | |
| *** suanand has joined #openstack-i18n | 04:43 | |
| *** amotoki has joined #openstack-i18n | 04:51 | |
| *** ykatabam has quit IRC | 05:42 | |
| *** openstackgerrit has quit IRC | 06:31 | |
| *** openstackgerrit has joined #openstack-i18n | 06:32 | |
| *** david-lyle has joined #openstack-i18n | 06:40 | |
| *** david-lyle has quit IRC | 06:45 | |
| *** katomo has joined #openstack-i18n | 07:10 | |
| katomo | Hi, amotoki. I'm in meeting, so maybe late response :) | 07:11 |
|---|---|---|
| amotoki | katomo: you don't need to rush. let me ping after your meeting is over. | 07:12 |
| katomo | thanks, see you later | 07:13 |
| amotoki | katomo: I think there are several points to be considered about the i18n document. | 07:13 |
| katomo | agree | 07:13 |
| amotoki | (1) a single document or multiple documents | 07:13 |
| amotoki | (2) document translation handling (we can leverage docs tool chain) -- do we want to translate 'i18n document' itself? | 07:14 |
| amotoki | (3) document style checking like niceness (I think it is useful) | 07:14 |
| amotoki | any other points? | 07:14 |
| katomo | language specific contents | 07:15 |
| katomo | maybe (2)' | 07:15 |
| amotoki | it's related to (2) but I think a different topic. | 07:16 |
| katomo | yes | 07:16 |
| amotoki | (4) allow to have language specific contents | 07:16 |
| katomo | may affect (1) : become multiple documents? | 07:17 |
| katomo | yes (4) | 07:17 |
| katomo | let's split topic | 07:17 |
| amotoki | sure. re: (4), we can use a separate top directory I think. | 07:18 |
| katomo | that's all at now from my thought | 07:18 |
| katomo | ah | 07:19 |
| katomo | (5) publish location | 07:19 |
| katomo | http://docs.openstack.org/developer/i18n ? okay? | 07:20 |
| amotoki | i have one minor thing: (6) infra config: do we follow most project jobs (pep8, doc, pytho27) or doc jobs (checknicesss, checkbuild, ....) | 07:20 |
| katomo | If okay, not so hard. If no, a little hard. | 07:21 |
| amotoki | Re: (5), developer/i18n looks a good start. as you say, it is easy. | 07:21 |
| katomo | yeah (6) | 07:21 |
| katomo | yes | 07:22 |
| amotoki | yes on what? | 07:22 |
| amotoki | on (5)? | 07:22 |
| katomo | Re: (5), yes | 07:22 |
| amotoki | okay, we agree to use http://docs.openstack.org/developer/i18n for the initial content location. | 07:23 |
| katomo | okay | 07:23 |
| katomo | I'll update the blueprint | 07:25 |
| amotoki | re (6) what do you think? | 07:25 |
| katomo | useful | 07:26 |
| katomo | i think we should add them | 07:26 |
| katomo | docs job is useful to me | 07:27 |
| amotoki | I am not sure we maintain scripts in our repo, so a need for python27 job would be low. | 07:28 |
| katomo | can we add both? | 07:28 |
| amotoki | yes if we can have anything, but we cannot use usual template in zuul/jbb. | 07:29 |
| katomo | hmm | 07:29 |
| amotoki | on the other hand, docs jos have various jobs but only checknicess and checkbuild have actual jobs and all of the rest are empty jobs. | 07:30 |
| amotoki | let me check on zuul/jjb template later | 07:30 |
| katomo | thanks. | 07:31 |
| katomo | i need to be familiar with them, too | 07:31 |
| amotoki | this is an example of security guide https://review.openstack.org/#/c/242308/ | 07:31 |
| amotoki | it looks good to me now. | 07:32 |
| amotoki | we can change our test easily, so it looks good to start with doc jobs (checkniceness and checkbuild). | 07:33 |
| *** adiantum has joined #openstack-i18n | 07:33 | |
| amotoki | katomo: regarding (2), in my understanding, the current doc tool chain supports a siglle document. right? | 07:34 |
| amotoki | because it uses sphinx-build inside. | 07:35 |
| *** Daisy has joined #openstack-i18n | 07:36 | |
| katomo | yes, but | 07:36 |
| katomo | loop call from outside | 07:36 |
| katomo | https://git.openstack.org/cgit/openstack/openstack-manuals/tree/doc-tools-check-languages.conf | 07:38 |
| katomo | controlled by this definition | 07:38 |
| amotoki | thanks for clarfication. | 07:39 |
| amotoki | I think a single document is a good start (as long as we can leverage the doc tool chain). | 07:39 |
| katomo | agree | 07:40 |
| amotoki | with a single document, we don't need to worry about if this content fit this document or i should create a new doc. | 07:40 |
| amotoki | let me summarize what we discuss so far: | 07:41 |
| amotoki | (1) a single document or multiple documents -- a single document looks better | 07:42 |
| amotoki | (2) document translation handling -- we can use the doc tool chain if we want to have | 07:42 |
| amotoki | (3) document style checking like niceness -- looks useful: checknicenss and checkbuild | 07:43 |
| amotoki | (4) allow to have language specific contents -- we can use a separate top directory in i18n repo. (perhaps we can update doc tool chain if want) | 07:44 |
| amotoki | (5) publish location -- http://docs.openstack.org/developer/i18n is a good start because the current infra tool chain support this location | 07:45 |
| amotoki | (6) infra config -- docs jobs looks suitable at the moment | 07:45 |
| katomo | okay | 07:47 |
| katomo | thanks to summarize | 07:48 |
| katomo | Hello Daisy | 07:50 |
| katomo | here? | 07:50 |
| Daisy | Hi, there | 07:50 |
| katomo | ^^ please take a look at summary by amotoki | 07:50 |
| katomo | discussion about i18n guide | 07:50 |
| Daisy | Reading | 07:50 |
| Daisy | about (2), the doc tool chain is for translation only ? | 07:51 |
| katomo | no, doc tool chain is useful for (3) | 07:52 |
| Daisy | katomo: I really don't like copy the doc tool chain to i18n repo. If there are other choices to refer to, I will not agree to copy. | 07:52 |
| katomo | hm | 07:53 |
| katomo | why? | 07:53 |
| Daisy | Because it's a kind of duplicate. | 07:53 |
| amotoki | the doc tool chain I proposed contains only three file. | 07:53 |
| amotoki | one is for translation and the other two are just a wrapper of sphinx. | 07:54 |
| Daisy | and has no relationship with i18n, except i18n doc building. | 07:54 |
| amotoki | for (3), openstack-doc-tool comes from doctool and we don't need to have a copy. | 07:54 |
| amotoki | Daisy: so perhaps we can drop build-rst.sh and build-all-rst.sh | 07:55 |
| amotoki | Daisy: generatepot-rst.sh can be simplified but I haven't investigated it yet. | 07:56 |
| amotoki | it can be deferred later. | 07:56 |
| amotoki | in the initial commit we don't need to support translation :-) | 07:57 |
| Daisy | amotoki: my opinion is to keep necessary files only. | 07:57 |
| Daisy | i18n repo is not a document repo. | 07:57 |
| amotoki | Daisy: agree. | 07:58 |
| Daisy | Thank you, amotoki. | 07:58 |
| amotoki | btw, do we want to support translation for the doc in i18n repo? | 07:59 |
| amotoki | s/the doc/the doc and others? | 07:59 |
| Daisy | I hope so. | 07:59 |
| Daisy | I don't see others till now. | 07:59 |
| amotoki | so, what are our conclusion? i18n repo is not a document repo. hopefully we support translation for the contents of i18n repo. | 08:02 |
| amotoki | what should tox env and job names be? | 08:02 |
| Daisy | tox is for testing ? | 08:02 |
| Daisy | what are jobs for ? | 08:02 |
| amotoki | jenkins jobs to check styling, check document build or check something... | 08:03 |
| katomo | Daisy, amotoki, so sorry, I'm offline at once. I should understand the situation and your requirements. | 08:04 |
| Daisy | i18n repo is not a document repo. It is used for i18n related assets. "how to contribute" could be regarded as a developer document for a code project. So treat it similar as doc folder under Neutron. | 08:04 |
| Daisy | Of course, we are i18n team. I hope our own document could be translated. | 08:05 |
| *** katomo has quit IRC | 08:05 | |
| Daisy | I see the document build command in tox.ini under Neutron. | 08:08 |
| amotoki | yes. i know | 08:08 |
| amotoki | we can follow it because we agree that we should a single document (doc/source/) | 08:09 |
| Daisy | That's better, because it looks simple. | 08:09 |
| Daisy | as (4), maybe not a separate top folder under i18n repo. | 08:11 |
| Daisy | Let me think | 08:11 |
| Daisy | under i18n repo, we have doc and tools. | 08:11 |
| Daisy | Under doc, we have our rst files, and "locale" folder to contain the translated pot and po files. | 08:11 |
| Daisy | I think Neutron doc doesn't support translation. | 08:11 |
| *** katomo has joined #openstack-i18n | 08:12 | |
| *** ykatabam has joined #openstack-i18n | 08:12 | |
| Daisy | I hope documentation team could have a way to refer to their tools other than copying codes directly. | 08:13 |
| Daisy | other than copying their source codes directly. | 08:13 |
| amotoki | Daisy: most tools from the docs team are maintained in doctool repo and it is published as doctool in PyPI. | 08:13 |
| amotoki | Daisy: but there are some exceptions because it is specific to a repo structure. | 08:14 |
| Daisy | ok. | 08:15 |
| Daisy | Could we follow the repo structure ? Maybe you could give me a sample of the repo structure ? | 08:15 |
| Daisy | like manuals ? | 08:15 |
| Daisy | or like ha-guide ? | 08:18 |
| amotoki | According to our dicsussion so far, it seems better to me to follow the structure of non-doc repo. thought? | 08:19 |
| Daisy | i'm looking at the structure of ha-guide. | 08:19 |
| katomo | doc/source ? | 08:19 |
| Daisy | amotoki: I like to follow the structure of non-doc repo. | 08:19 |
| amotoki | katomo: yes, doc/source. | 08:20 |
| katomo | manuals and ha-guide repos are a little complex to support multi docs. | 08:20 |
| katomo | Daisy: agree to non-doc repo. | 08:21 |
| Daisy | thank you, katomo | 08:21 |
| Daisy | If we have multiple documents for i18n, maybe we could ask for a i18n-doc repo separately | 08:21 |
| Daisy | in the future, I mean, if we have multiple documents for i18n, we could ask for a i18n-doc repo. | 08:22 |
| Daisy | But for now, keep things simple, till we grow mature。 | 08:22 |
| katomo | sounds good idea | 08:22 |
| amotoki | agree. | 08:23 |
| amotoki | let's start with simple. | 08:23 |
| katomo | yes :) | 08:24 |
| katomo | I'll update the patch | 08:25 |
| *** katomo has quit IRC | 08:35 | |
| *** Daisy has quit IRC | 08:38 | |
| *** Daisy has joined #openstack-i18n | 08:38 | |
| *** openstackstatus has quit IRC | 08:42 | |
| *** Daisy has quit IRC | 08:43 | |
| *** Daisy has joined #openstack-i18n | 08:52 | |
| *** Daisy has quit IRC | 08:54 | |
| *** ygbo has joined #openstack-i18n | 08:56 | |
| *** rsimai_away is now known as rsimai | 08:58 | |
| *** ykatabam has left #openstack-i18n | 09:15 | |
| openstackgerrit | KATO Tomoyuki proposed openstack/i18n: Create I18n Contributor Guide configuration https://review.openstack.org/241103 | 09:16 |
| *** Besnik has joined #openstack-i18n | 09:35 | |
| *** Besnik has left #openstack-i18n | 09:40 | |
| *** epico has joined #openstack-i18n | 10:02 | |
| *** epico has quit IRC | 10:31 | |
| *** Daisy has joined #openstack-i18n | 10:37 | |
| *** Daisy has quit IRC | 10:41 | |
| *** ykatabam has joined #openstack-i18n | 11:51 | |
| *** ykatabam has left #openstack-i18n | 11:55 | |
| *** Daisy has joined #openstack-i18n | 12:13 | |
| *** Daisy has quit IRC | 12:14 | |
| *** ykatabam has joined #openstack-i18n | 12:38 | |
| *** suanand has quit IRC | 12:54 | |
| *** amotoki has quit IRC | 15:19 | |
| *** ygbo has quit IRC | 16:18 | |
| *** ygbo has joined #openstack-i18n | 16:20 | |
| *** rsimai has quit IRC | 16:36 | |
| *** adiantum has quit IRC | 17:00 | |
| *** ygbo has quit IRC | 17:49 | |
| *** Besnik has joined #openstack-i18n | 18:55 | |
| *** Besnik has left #openstack-i18n | 18:56 | |
| *** openstackstatus has joined #openstack-i18n | 19:35 | |
| *** ChanServ sets mode: +v openstackstatus | 19:35 | |
| -openstackstatus- NOTICE: Gerrit will be offline at 20:00-20:15 UTC today (starting 20 minutes from now) for scheduled project rename maintenance | 19:40 | |
| -openstackstatus- NOTICE: Gerrit is offline until 20:15 UTC today for scheduled project rename maintenance | 20:02 | |
| *** ChanServ changes topic to "Gerrit is offline until 20:15 UTC today for scheduled project rename maintenance" | 20:02 | |
| *** ChanServ changes topic to "OpenStack goes multilingual! | I18n & L10n channel" | 20:36 | |
| *** openstackgerrit has quit IRC | 21:01 | |
| *** openstackgerrit has joined #openstack-i18n | 21:02 | |
| *** doug-fish has quit IRC | 22:40 | |
| *** ykatabam has quit IRC | 23:46 | |
Generated by irclog2html.py 2.14.0 by Marius Gedminas - find it at mg.pov.lt!