*** yangyapeng has quit IRC | 00:11 | |
*** yangyapeng has joined #openstack-doc | 00:11 | |
*** yangyapeng has quit IRC | 00:16 | |
*** thorst has joined #openstack-doc | 00:29 | |
*** thorst has quit IRC | 00:32 | |
*** masaki has joined #openstack-doc | 01:01 | |
*** dmacpher has joined #openstack-doc | 01:03 | |
*** phuongnh has joined #openstack-doc | 01:08 | |
*** masaki has quit IRC | 01:08 | |
*** masaki has joined #openstack-doc | 01:09 | |
*** thorst has joined #openstack-doc | 01:10 | |
*** masaki has quit IRC | 01:10 | |
*** masaki has joined #openstack-doc | 01:11 | |
*** masaki has quit IRC | 01:17 | |
*** yangyapeng has joined #openstack-doc | 01:18 | |
*** yangyapeng has quit IRC | 01:19 | |
*** yangyapeng has joined #openstack-doc | 01:19 | |
*** yangyape_ has joined #openstack-doc | 01:20 | |
*** thorst has quit IRC | 01:20 | |
*** masaki has joined #openstack-doc | 01:21 | |
*** yangyapeng has quit IRC | 01:24 | |
*** yangyape_ has quit IRC | 01:28 | |
*** yangyapeng has joined #openstack-doc | 01:29 | |
*** masaki has quit IRC | 01:36 | |
*** masaki has joined #openstack-doc | 01:36 | |
*** thorst has joined #openstack-doc | 01:59 | |
*** thorst has quit IRC | 02:00 | |
*** masaki has quit IRC | 02:31 | |
*** madorn has quit IRC | 02:34 | |
*** madorn has joined #openstack-doc | 02:35 | |
openstackgerrit | Chason Chan proposed openstack/openstack-manuals master: [WIP]Add Database service user guide https://review.openstack.org/511684 | 02:45 |
---|---|---|
*** masaki has joined #openstack-doc | 02:47 | |
*** thorst has joined #openstack-doc | 03:10 | |
*** thorst has quit IRC | 03:15 | |
*** nicolasbock has quit IRC | 03:16 | |
*** edmondsw has joined #openstack-doc | 03:38 | |
*** yangyapeng has quit IRC | 03:40 | |
*** yangyapeng has joined #openstack-doc | 03:41 | |
*** edmondsw has quit IRC | 03:45 | |
*** pcaruana has joined #openstack-doc | 04:27 | |
*** egallen has joined #openstack-doc | 04:55 | |
*** pcaruana has quit IRC | 04:56 | |
*** AJaeger has joined #openstack-doc | 04:57 | |
*** AJaeger has quit IRC | 04:57 | |
*** AJaeger has joined #openstack-doc | 05:01 | |
*** egallen has quit IRC | 05:03 | |
*** thorst has joined #openstack-doc | 05:11 | |
*** thorst has quit IRC | 05:15 | |
*** egallen has joined #openstack-doc | 05:19 | |
*** egallen has quit IRC | 05:19 | |
*** chlong has joined #openstack-doc | 05:20 | |
*** gouthamr has quit IRC | 05:24 | |
*** edmondsw has joined #openstack-doc | 05:27 | |
*** pcaruana has joined #openstack-doc | 05:30 | |
*** edmondsw has quit IRC | 05:32 | |
*** pcaruana has quit IRC | 05:39 | |
*** rcernin has joined #openstack-doc | 05:41 | |
*** spectr has quit IRC | 05:58 | |
*** spectr has joined #openstack-doc | 05:58 | |
*** phuongnh has quit IRC | 06:30 | |
*** dmacpher has quit IRC | 06:32 | |
*** eumel8 has joined #openstack-doc | 06:48 | |
eumel8 | morning | 06:48 |
*** masaki has quit IRC | 07:02 | |
*** masaki has joined #openstack-doc | 07:03 | |
*** masaki has quit IRC | 07:04 | |
*** masaki has joined #openstack-doc | 07:04 | |
*** masaki has quit IRC | 07:05 | |
*** masaki has joined #openstack-doc | 07:06 | |
*** pcaruana has joined #openstack-doc | 07:07 | |
openstackgerrit | OpenStack Proposal Bot proposed openstack/openstack-manuals master: Imported Translations from Zanata https://review.openstack.org/510273 | 07:08 |
*** suyog has quit IRC | 07:09 | |
*** thorst has joined #openstack-doc | 07:12 | |
*** edmondsw has joined #openstack-doc | 07:15 | |
*** thorst has quit IRC | 07:17 | |
*** edmondsw has quit IRC | 07:20 | |
*** tesseract has joined #openstack-doc | 07:22 | |
*** spectr has quit IRC | 07:26 | |
*** tesseract has quit IRC | 07:26 | |
*** rcernin has quit IRC | 07:26 | |
*** pcaruana has quit IRC | 07:26 | |
*** masaki has quit IRC | 07:33 | |
*** masaki has joined #openstack-doc | 07:36 | |
*** spectr has joined #openstack-doc | 07:40 | |
*** rcernin has joined #openstack-doc | 07:40 | |
*** pcaruana has joined #openstack-doc | 07:40 | |
*** jpena|off is now known as jpena | 07:41 | |
*** spectr has quit IRC | 07:43 | |
*** pcaruana has quit IRC | 07:44 | |
*** pcaruana has joined #openstack-doc | 07:44 | |
*** spectr has joined #openstack-doc | 07:44 | |
*** masaki has quit IRC | 07:45 | |
*** masaki has joined #openstack-doc | 07:53 | |
*** egallen has joined #openstack-doc | 08:07 | |
*** thorst has joined #openstack-doc | 08:12 | |
*** thorst has quit IRC | 08:17 | |
*** phuongnh has joined #openstack-doc | 08:30 | |
asettle | Morning o/ | 08:38 |
*** johnthetubaguy has quit IRC | 08:39 | |
*** johnthetubaguy has joined #openstack-doc | 08:40 | |
*** thorst has joined #openstack-doc | 08:41 | |
*** pkovar has joined #openstack-doc | 08:44 | |
*** thorst has quit IRC | 08:45 | |
*** fragatina has joined #openstack-doc | 08:53 | |
*** rcernin has quit IRC | 08:59 | |
*** spectr has quit IRC | 08:59 | |
*** pcaruana has quit IRC | 08:59 | |
*** edmondsw has joined #openstack-doc | 09:04 | |
chason | o/ | 09:07 |
*** edmondsw has quit IRC | 09:08 | |
*** rcernin has joined #openstack-doc | 09:12 | |
*** spectr has joined #openstack-doc | 09:12 | |
*** pcaruana has joined #openstack-doc | 09:13 | |
*** tosky has joined #openstack-doc | 09:28 | |
*** chlong has quit IRC | 09:40 | |
*** fragatina has quit IRC | 09:51 | |
*** fragatina has joined #openstack-doc | 09:53 | |
*** fragatina has quit IRC | 09:55 | |
*** fragatina has joined #openstack-doc | 09:56 | |
*** yangyapeng has quit IRC | 10:02 | |
*** phuongnh has quit IRC | 10:03 | |
*** sambetts|afk is now known as sambetts | 10:05 | |
*** masaki has quit IRC | 10:10 | |
*** masaki has joined #openstack-doc | 10:10 | |
*** masaki has quit IRC | 10:11 | |
*** pbourke has quit IRC | 10:17 | |
pkovar | \o | 10:17 |
*** fragatina has quit IRC | 10:18 | |
*** pbourke has joined #openstack-doc | 10:19 | |
*** pkovar has quit IRC | 10:24 | |
*** thorst has joined #openstack-doc | 10:42 | |
*** thorst_ has joined #openstack-doc | 10:45 | |
*** thorst has quit IRC | 10:47 | |
*** pcaruana has quit IRC | 10:48 | |
*** yamamoto has quit IRC | 10:48 | |
*** thorst_ has quit IRC | 10:49 | |
*** pkovar has joined #openstack-doc | 10:52 | |
openstackgerrit | OpenStack Proposal Bot proposed openstack/training-guides master: Imported Translations from Zanata https://review.openstack.org/511196 | 10:54 |
*** nicolasbock has joined #openstack-doc | 11:09 | |
*** nicolasbock has quit IRC | 11:14 | |
*** edmondsw has joined #openstack-doc | 11:20 | |
*** alexchadin has joined #openstack-doc | 11:24 | |
*** Qiming has quit IRC | 11:26 | |
*** nicolasbock has joined #openstack-doc | 11:26 | |
*** Qiming has joined #openstack-doc | 11:28 | |
*** yamamoto has joined #openstack-doc | 11:40 | |
*** yamamoto has quit IRC | 11:45 | |
*** yamamoto has joined #openstack-doc | 11:48 | |
*** pblaho has joined #openstack-doc | 11:53 | |
*** thorst has joined #openstack-doc | 11:53 | |
*** yamamoto has quit IRC | 11:54 | |
*** tpsilva has joined #openstack-doc | 12:02 | |
evrardjp | AJaeger: problem with translation jobs? | 12:10 |
*** dmacpher has joined #openstack-doc | 12:12 | |
openstackgerrit | Merged openstack/openstack-manuals master: Remove '``' (double backticks) from heading https://review.openstack.org/511171 | 12:14 |
eumel8 | evrardjp: which one? | 12:15 |
evrardjp | I don't know that's why I am asking... I saw that in the logs | 12:15 |
eumel8 | asettle, pkovar: 511171 - sorry, maybe merged too early | 12:17 |
eumel8 | evrardjp: the old jobs are fine as I can see, the new zuul v3 jobs are going slowly on after the repair of the mirror last night. | 12:18 |
evrardjp | k.. i see :) I know the feeling.... | 12:19 |
eumel8 | zuul v3 status seems empty .. or it takes another while to collect the status of the queue ;) | 12:21 |
*** yamamoto has joined #openstack-doc | 12:28 | |
*** yamamoto has quit IRC | 12:29 | |
AJaeger | evrardjp: why? What do you see? | 12:29 |
evrardjp | AJaeger: nothing, but if you seen something I can help you with, just don't hesitate. | 12:30 |
evrardjp | Just reading the log. | 12:30 |
AJaeger | evrardjp: the zuul v3 jobs have not run yet - hope we see them running tomorrow ;) | 12:31 |
evrardjp | That would be nice, but I can tell you I won't check any job status until Monday. | 12:31 |
evrardjp | :p | 12:31 |
AJaeger | evrardjp: I'm happy to ask for help in case those don't work. We now have everything merged that we knew so far broken - so time for next try ;) | 12:31 |
*** Qiming has quit IRC | 12:41 | |
*** Qiming has joined #openstack-doc | 12:42 | |
*** jpena is now known as jpena|lunch | 12:43 | |
*** pcaruana has joined #openstack-doc | 12:48 | |
*** alexchadin has quit IRC | 12:50 | |
*** alexchadin has joined #openstack-doc | 12:51 | |
*** dustins has joined #openstack-doc | 12:51 | |
*** eumel8 has quit IRC | 12:52 | |
*** spectr has quit IRC | 12:57 | |
*** spectr has joined #openstack-doc | 13:01 | |
dhellmann | o/ | 13:04 |
*** yamamoto has joined #openstack-doc | 13:30 | |
*** Qiming has quit IRC | 13:31 | |
*** chlong has joined #openstack-doc | 13:33 | |
*** Qiming has joined #openstack-doc | 13:33 | |
*** yamamoto has quit IRC | 13:40 | |
*** jpena|lunch is now known as jpena | 13:41 | |
*** rcernin has quit IRC | 13:44 | |
*** pkovar has quit IRC | 13:46 | |
*** d0ugal has quit IRC | 13:48 | |
*** gouthamr has joined #openstack-doc | 13:49 | |
*** yamamoto has joined #openstack-doc | 13:50 | |
*** gouthamr has quit IRC | 13:51 | |
*** gouthamr has joined #openstack-doc | 13:51 | |
*** eumel8 has joined #openstack-doc | 14:00 | |
*** d0ugal has joined #openstack-doc | 14:03 | |
*** alexchadin has quit IRC | 14:12 | |
*** Qiming has quit IRC | 14:19 | |
*** Qiming has joined #openstack-doc | 14:19 | |
*** yamamoto has quit IRC | 14:21 | |
*** catintheroof has joined #openstack-doc | 14:23 | |
*** Dinesh_Bhor has quit IRC | 14:34 | |
*** yamamoto has joined #openstack-doc | 14:41 | |
*** KeithMnemonic1 has joined #openstack-doc | 14:43 | |
*** rcernin has joined #openstack-doc | 14:45 | |
*** spectr has quit IRC | 14:46 | |
*** KeithMnemonic has quit IRC | 14:47 | |
*** yangyapeng has joined #openstack-doc | 14:54 | |
*** rcernin has quit IRC | 15:03 | |
*** yangyapeng has quit IRC | 15:14 | |
*** yangyapeng has joined #openstack-doc | 15:15 | |
*** pkovar has joined #openstack-doc | 15:17 | |
*** yangyapeng has quit IRC | 15:20 | |
*** yangyapeng has joined #openstack-doc | 15:21 | |
*** alex_xu has quit IRC | 15:22 | |
*** Qiming has quit IRC | 15:29 | |
*** alex_xu has joined #openstack-doc | 15:31 | |
*** Qiming has joined #openstack-doc | 15:33 | |
*** chlong has quit IRC | 15:53 | |
*** Qiming has quit IRC | 15:55 | |
*** Qiming has joined #openstack-doc | 15:57 | |
openstackgerrit | Merged openstack/training-guides master: Imported Translations from Zanata https://review.openstack.org/511196 | 16:03 |
*** reed has quit IRC | 16:04 | |
*** reed has joined #openstack-doc | 16:07 | |
*** pcaruana has quit IRC | 16:23 | |
*** yamamoto has quit IRC | 16:29 | |
*** AJaeger has quit IRC | 17:00 | |
*** AJaeger has joined #openstack-doc | 17:00 | |
*** jpena is now known as jpena|off | 17:03 | |
*** yamamoto has joined #openstack-doc | 17:09 | |
*** yamamoto has quit IRC | 17:09 | |
*** sambetts is now known as sambetts|adk | 17:20 | |
*** sambetts|adk is now known as sambetts|afk | 17:20 | |
*** catintheroof has quit IRC | 17:25 | |
*** catintheroof has joined #openstack-doc | 17:25 | |
*** catintheroof has quit IRC | 17:29 | |
*** tosky has quit IRC | 17:41 | |
*** nicolasbock has quit IRC | 17:42 | |
*** pkovar has quit IRC | 17:47 | |
openstackgerrit | Mike Perez proposed openstack/contributor-guide master: Initial commit of the Contributor Portal https://review.openstack.org/511033 | 17:59 |
*** yamamoto has joined #openstack-doc | 18:10 | |
*** pblaho has quit IRC | 18:12 | |
*** thingee has joined #openstack-doc | 18:13 | |
*** tosky has joined #openstack-doc | 18:13 | |
thingee | ildikov: going to start on the work for publishing the contributor guide. wondering what the url should be | 18:16 |
thingee | ildikov: https://docs.openstack.org/contributor-guide ? | 18:17 |
thingee | anyone in this channel have an opinion? | 18:17 |
thingee | am I understanding right that the post jobs for publishing docs is leaning on the instructions with tox? | 18:18 |
*** yamamoto has quit IRC | 18:19 | |
AJaeger | thingee: by default repos publish to docs.openstack.org/REPO/latest/ | 18:21 |
AJaeger | thingee: that's done with the usual sphinx build - like cinder or nova does | 18:22 |
AJaeger | I suggest to do the same here as well and not invent anything new | 18:22 |
thingee | AJaeger: sounds perfect | 18:23 |
*** catintheroof has joined #openstack-doc | 18:33 | |
*** gouthamr has quit IRC | 18:47 | |
*** AJaeger has quit IRC | 19:10 | |
*** gouthamr has joined #openstack-doc | 19:22 | |
*** gouthamr_ has joined #openstack-doc | 19:24 | |
*** gouthamr has quit IRC | 19:26 | |
ildikov | thingee: sorry, I was flying | 19:38 |
ildikov | thingee: reading back I agree with AJaeger too :) | 19:39 |
thingee | ildikov: yup, it has already been posted for review https://review.openstack.org/#/c/511946 | 19:41 |
ildikov | thingee: awesome!!! Thanks! :) | 19:42 |
thingee | dhellmann: do you have a second to answer a question about sphinx with the contributor guide project. | 19:42 |
thingee | ? | 19:43 |
dhellmann | thingee : I can try | 19:43 |
dhellmann | thingee : regarding the "contributor-guide" name, you'll want to make sure that doesn't conflict with the old name of the doc team contributor guide | 19:43 |
dhellmann | I *think* that was contrib-guide but I'm not 100% sure | 19:44 |
thingee | dhellmann: yes thank you, I'm aware of having to help there. | 19:44 |
dhellmann | today there's a redirect from the old name to the new, let me look for that | 19:44 |
dhellmann | redirectmatch 301 ^/contributor-guide/(.*)$ /doc-contrib-guide/$1 | 19:44 |
dhellmann | so you don't want to call it "contributor-guide" I think | 19:45 |
dhellmann | maybe just "contributing"? | 19:45 |
thingee | dang. | 19:45 |
dhellmann | sorry | 19:45 |
dhellmann | or we could decide not to redirect, I guess? something to discuss with pkovar | 19:45 |
thingee | yeah, I think the name indicates some general contributor guide. Later you figure it out it's doc specific. | 19:45 |
thingee | that definitely halts things. I'll have to go back to that when I have mind unwrapped with this other question. | 19:46 |
dhellmann | yeah, the doc guide is now at /doc-contrib-guide for that reason | 19:46 |
thingee | dhellmann: ok, I'll bring it up on the list. | 19:47 |
dhellmann | I derailed you; did you have another sphinx question? | 19:49 |
thingee | dhellmann: back to my question, the landing page for contributors on openstack.org/community (Contributor portal) links to general documentation stored in the sphinx project (Contributor Guide). At the PTG we decided to have the general documentation only stored in the contributor guide repo, but the project specific content will reside still in the project's specific contributor documentation. | 19:49 |
thingee | so now comes the question of how exactly we accomplish that. | 19:49 |
dhellmann | my idea at the time was just to link over to the project docs, not to do anything fancy trying to publish from source files living in multiple repos | 19:50 |
dhellmann | so you have the "here's a lot of general info about contributing to openstack" guide and the "here's how you contribute to zaqar" guide | 19:50 |
dhellmann | that also exposes to the contributor right away that although we're 1 community we're also many teams, and each team has its own variations, which is something they need to understand to be really effective | 19:53 |
thingee | dhellmann: yeah, so from the contributor portal it could have for example project links that look like docs.o.o/contributor-guide/latest/?next_guide=<some_project_dev_doc_url> ... these will come from the docs contributor field in the projects.yaml | 19:53 |
thingee | the last page for example of the contributor guide could say "you're done with the general docs yada yada go to nova specific contributor docs <link>" | 19:54 |
thingee | should verify that it actually exists in projects yaml? or pull it from projects yaml directly maybe | 19:54 |
thingee | embedding a url like that could be phishy | 19:55 |
dhellmann | the docs repo has info about which projects have contributor docs | 19:56 |
dhellmann | so we could pull it from there, if we want to do it automatically | 19:56 |
dhellmann | but we could also just make the list manually | 19:56 |
dhellmann | *or* the link in the guide you're building could link to a page in the openstack-manuals repo that is built automatically | 19:56 |
dhellmann | that wouldn't involve pulling data from yaml files across repos during builds | 19:57 |
thingee | dhellmann: yes a safe way to do it would be great. Ideally since you picked the project from the contributor portal it should just list the project dev doc you picked, otherwise it lists them all assuming the person went directly to docs.o.o/contributor-guide | 19:57 |
dhellmann | ah, I see, sure | 19:57 |
dhellmann | in that case you'll want to consume the yaml file(s) in the openstack-manuals repo | 19:57 |
dhellmann | https://docs.openstack.org/doc-contrib-guide/doc-tools/template-generator.html has details on that file format | 19:58 |
dhellmann | and I'm happy to help explain that in more detail if it's not sufficient | 19:58 |
thingee | also people wanted to link directly to docs.o.o/contributor-guide in their repos so someone doesn't have to go through the contributor portal. | 19:58 |
dhellmann | oh, hmm, I thought we had a flag for "has_contrib_guide" but we don't | 19:58 |
dhellmann | sure, that makes sense too | 19:59 |
dhellmann | ugh, apparently my refrigerator just dumped a bunch of water on the kitchen floor, so I need to go deal with that. I'll probably be back online in a bit. | 19:59 |
thingee | dhellmann: yikes, good luck. Thanks for showing me this template generator. This could lead me in the right direction. | 20:00 |
thingee | if anyone else in this channel has ideas, please let me know. Going to have some lunch now. :) | 20:01 |
*** AJaeger has joined #openstack-doc | 20:19 | |
*** KeithMnemonic1 has quit IRC | 20:19 | |
*** AJaeger has quit IRC | 20:20 | |
*** thorst has quit IRC | 20:23 | |
*** thorst has joined #openstack-doc | 20:23 | |
*** thorst has quit IRC | 20:28 | |
*** thorst has joined #openstack-doc | 20:44 | |
*** edmondsw has quit IRC | 20:45 | |
*** thorst has quit IRC | 20:48 | |
*** catintheroof has quit IRC | 21:10 | |
*** dustins has quit IRC | 21:28 | |
*** thorst has joined #openstack-doc | 21:38 | |
*** thorst has quit IRC | 21:42 | |
*** tpsilva has quit IRC | 22:10 | |
*** egallen has quit IRC | 22:20 | |
*** gouthamr_ has quit IRC | 22:23 | |
*** eumel8 has quit IRC | 23:20 | |
*** gouthamr has joined #openstack-doc | 23:30 | |
*** gouthamr_ has joined #openstack-doc | 23:43 | |
*** gouthamr has quit IRC | 23:46 | |
*** gouthamr_ has quit IRC | 23:57 |
Generated by irclog2html.py 2.15.3 by Marius Gedminas - find it at mg.pov.lt!