Friday, 2017-10-13

*** yangyapeng has quit IRC00:11
*** yangyapeng has joined #openstack-doc00:11
*** yangyapeng has quit IRC00:16
*** thorst has joined #openstack-doc00:29
*** thorst has quit IRC00:32
*** masaki has joined #openstack-doc01:01
*** dmacpher has joined #openstack-doc01:03
*** phuongnh has joined #openstack-doc01:08
*** masaki has quit IRC01:08
*** masaki has joined #openstack-doc01:09
*** thorst has joined #openstack-doc01:10
*** masaki has quit IRC01:10
*** masaki has joined #openstack-doc01:11
*** masaki has quit IRC01:17
*** yangyapeng has joined #openstack-doc01:18
*** yangyapeng has quit IRC01:19
*** yangyapeng has joined #openstack-doc01:19
*** yangyape_ has joined #openstack-doc01:20
*** thorst has quit IRC01:20
*** masaki has joined #openstack-doc01:21
*** yangyapeng has quit IRC01:24
*** yangyape_ has quit IRC01:28
*** yangyapeng has joined #openstack-doc01:29
*** masaki has quit IRC01:36
*** masaki has joined #openstack-doc01:36
*** thorst has joined #openstack-doc01:59
*** thorst has quit IRC02:00
*** masaki has quit IRC02:31
*** madorn has quit IRC02:34
*** madorn has joined #openstack-doc02:35
openstackgerritChason Chan proposed openstack/openstack-manuals master: [WIP]Add Database service user guide  https://review.openstack.org/51168402:45
*** masaki has joined #openstack-doc02:47
*** thorst has joined #openstack-doc03:10
*** thorst has quit IRC03:15
*** nicolasbock has quit IRC03:16
*** edmondsw has joined #openstack-doc03:38
*** yangyapeng has quit IRC03:40
*** yangyapeng has joined #openstack-doc03:41
*** edmondsw has quit IRC03:45
*** pcaruana has joined #openstack-doc04:27
*** egallen has joined #openstack-doc04:55
*** pcaruana has quit IRC04:56
*** AJaeger has joined #openstack-doc04:57
*** AJaeger has quit IRC04:57
*** AJaeger has joined #openstack-doc05:01
*** egallen has quit IRC05:03
*** thorst has joined #openstack-doc05:11
*** thorst has quit IRC05:15
*** egallen has joined #openstack-doc05:19
*** egallen has quit IRC05:19
*** chlong has joined #openstack-doc05:20
*** gouthamr has quit IRC05:24
*** edmondsw has joined #openstack-doc05:27
*** pcaruana has joined #openstack-doc05:30
*** edmondsw has quit IRC05:32
*** pcaruana has quit IRC05:39
*** rcernin has joined #openstack-doc05:41
*** spectr has quit IRC05:58
*** spectr has joined #openstack-doc05:58
*** phuongnh has quit IRC06:30
*** dmacpher has quit IRC06:32
*** eumel8 has joined #openstack-doc06:48
eumel8morning06:48
*** masaki has quit IRC07:02
*** masaki has joined #openstack-doc07:03
*** masaki has quit IRC07:04
*** masaki has joined #openstack-doc07:04
*** masaki has quit IRC07:05
*** masaki has joined #openstack-doc07:06
*** pcaruana has joined #openstack-doc07:07
openstackgerritOpenStack Proposal Bot proposed openstack/openstack-manuals master: Imported Translations from Zanata  https://review.openstack.org/51027307:08
*** suyog has quit IRC07:09
*** thorst has joined #openstack-doc07:12
*** edmondsw has joined #openstack-doc07:15
*** thorst has quit IRC07:17
*** edmondsw has quit IRC07:20
*** tesseract has joined #openstack-doc07:22
*** spectr has quit IRC07:26
*** tesseract has quit IRC07:26
*** rcernin has quit IRC07:26
*** pcaruana has quit IRC07:26
*** masaki has quit IRC07:33
*** masaki has joined #openstack-doc07:36
*** spectr has joined #openstack-doc07:40
*** rcernin has joined #openstack-doc07:40
*** pcaruana has joined #openstack-doc07:40
*** jpena|off is now known as jpena07:41
*** spectr has quit IRC07:43
*** pcaruana has quit IRC07:44
*** pcaruana has joined #openstack-doc07:44
*** spectr has joined #openstack-doc07:44
*** masaki has quit IRC07:45
*** masaki has joined #openstack-doc07:53
*** egallen has joined #openstack-doc08:07
*** thorst has joined #openstack-doc08:12
*** thorst has quit IRC08:17
*** phuongnh has joined #openstack-doc08:30
asettleMorning o/08:38
*** johnthetubaguy has quit IRC08:39
*** johnthetubaguy has joined #openstack-doc08:40
*** thorst has joined #openstack-doc08:41
*** pkovar has joined #openstack-doc08:44
*** thorst has quit IRC08:45
*** fragatina has joined #openstack-doc08:53
*** rcernin has quit IRC08:59
*** spectr has quit IRC08:59
*** pcaruana has quit IRC08:59
*** edmondsw has joined #openstack-doc09:04
chasono/09:07
*** edmondsw has quit IRC09:08
*** rcernin has joined #openstack-doc09:12
*** spectr has joined #openstack-doc09:12
*** pcaruana has joined #openstack-doc09:13
*** tosky has joined #openstack-doc09:28
*** chlong has quit IRC09:40
*** fragatina has quit IRC09:51
*** fragatina has joined #openstack-doc09:53
*** fragatina has quit IRC09:55
*** fragatina has joined #openstack-doc09:56
*** yangyapeng has quit IRC10:02
*** phuongnh has quit IRC10:03
*** sambetts|afk is now known as sambetts10:05
*** masaki has quit IRC10:10
*** masaki has joined #openstack-doc10:10
*** masaki has quit IRC10:11
*** pbourke has quit IRC10:17
pkovar\o10:17
*** fragatina has quit IRC10:18
*** pbourke has joined #openstack-doc10:19
*** pkovar has quit IRC10:24
*** thorst has joined #openstack-doc10:42
*** thorst_ has joined #openstack-doc10:45
*** thorst has quit IRC10:47
*** pcaruana has quit IRC10:48
*** yamamoto has quit IRC10:48
*** thorst_ has quit IRC10:49
*** pkovar has joined #openstack-doc10:52
openstackgerritOpenStack Proposal Bot proposed openstack/training-guides master: Imported Translations from Zanata  https://review.openstack.org/51119610:54
*** nicolasbock has joined #openstack-doc11:09
*** nicolasbock has quit IRC11:14
*** edmondsw has joined #openstack-doc11:20
*** alexchadin has joined #openstack-doc11:24
*** Qiming has quit IRC11:26
*** nicolasbock has joined #openstack-doc11:26
*** Qiming has joined #openstack-doc11:28
*** yamamoto has joined #openstack-doc11:40
*** yamamoto has quit IRC11:45
*** yamamoto has joined #openstack-doc11:48
*** pblaho has joined #openstack-doc11:53
*** thorst has joined #openstack-doc11:53
*** yamamoto has quit IRC11:54
*** tpsilva has joined #openstack-doc12:02
evrardjpAJaeger: problem with translation jobs?12:10
*** dmacpher has joined #openstack-doc12:12
openstackgerritMerged openstack/openstack-manuals master: Remove '``' (double backticks) from heading  https://review.openstack.org/51117112:14
eumel8evrardjp: which one?12:15
evrardjpI don't know that's why I am asking... I saw that in the logs12:15
eumel8asettle, pkovar: 511171 - sorry, maybe merged too early12:17
eumel8evrardjp: 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
evrardjpk.. i see :) I know the feeling....12:19
eumel8zuul v3 status seems empty .. or it takes another while to collect the status of the queue ;)12:21
*** yamamoto has joined #openstack-doc12:28
*** yamamoto has quit IRC12:29
AJaegerevrardjp: why? What do you see?12:29
evrardjpAJaeger: nothing, but if you seen something I can help you with, just don't hesitate.12:30
evrardjpJust reading the log.12:30
AJaegerevrardjp: the zuul v3 jobs have not run yet - hope we see them running tomorrow ;)12:31
evrardjpThat would be nice, but I can tell you I won't check any job status until Monday.12:31
evrardjp:p12:31
AJaegerevrardjp: 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 IRC12:41
*** Qiming has joined #openstack-doc12:42
*** jpena is now known as jpena|lunch12:43
*** pcaruana has joined #openstack-doc12:48
*** alexchadin has quit IRC12:50
*** alexchadin has joined #openstack-doc12:51
*** dustins has joined #openstack-doc12:51
*** eumel8 has quit IRC12:52
*** spectr has quit IRC12:57
*** spectr has joined #openstack-doc13:01
dhellmanno/13:04
*** yamamoto has joined #openstack-doc13:30
*** Qiming has quit IRC13:31
*** chlong has joined #openstack-doc13:33
*** Qiming has joined #openstack-doc13:33
*** yamamoto has quit IRC13:40
*** jpena|lunch is now known as jpena13:41
*** rcernin has quit IRC13:44
*** pkovar has quit IRC13:46
*** d0ugal has quit IRC13:48
*** gouthamr has joined #openstack-doc13:49
*** yamamoto has joined #openstack-doc13:50
*** gouthamr has quit IRC13:51
*** gouthamr has joined #openstack-doc13:51
*** eumel8 has joined #openstack-doc14:00
*** d0ugal has joined #openstack-doc14:03
*** alexchadin has quit IRC14:12
*** Qiming has quit IRC14:19
*** Qiming has joined #openstack-doc14:19
*** yamamoto has quit IRC14:21
*** catintheroof has joined #openstack-doc14:23
*** Dinesh_Bhor has quit IRC14:34
*** yamamoto has joined #openstack-doc14:41
*** KeithMnemonic1 has joined #openstack-doc14:43
*** rcernin has joined #openstack-doc14:45
*** spectr has quit IRC14:46
*** KeithMnemonic has quit IRC14:47
*** yangyapeng has joined #openstack-doc14:54
*** rcernin has quit IRC15:03
*** yangyapeng has quit IRC15:14
*** yangyapeng has joined #openstack-doc15:15
*** pkovar has joined #openstack-doc15:17
*** yangyapeng has quit IRC15:20
*** yangyapeng has joined #openstack-doc15:21
*** alex_xu has quit IRC15:22
*** Qiming has quit IRC15:29
*** alex_xu has joined #openstack-doc15:31
*** Qiming has joined #openstack-doc15:33
*** chlong has quit IRC15:53
*** Qiming has quit IRC15:55
*** Qiming has joined #openstack-doc15:57
openstackgerritMerged openstack/training-guides master: Imported Translations from Zanata  https://review.openstack.org/51119616:03
*** reed has quit IRC16:04
*** reed has joined #openstack-doc16:07
*** pcaruana has quit IRC16:23
*** yamamoto has quit IRC16:29
*** AJaeger has quit IRC17:00
*** AJaeger has joined #openstack-doc17:00
*** jpena is now known as jpena|off17:03
*** yamamoto has joined #openstack-doc17:09
*** yamamoto has quit IRC17:09
*** sambetts is now known as sambetts|adk17:20
*** sambetts|adk is now known as sambetts|afk17:20
*** catintheroof has quit IRC17:25
*** catintheroof has joined #openstack-doc17:25
*** catintheroof has quit IRC17:29
*** tosky has quit IRC17:41
*** nicolasbock has quit IRC17:42
*** pkovar has quit IRC17:47
openstackgerritMike Perez proposed openstack/contributor-guide master: Initial commit of the Contributor Portal  https://review.openstack.org/51103317:59
*** yamamoto has joined #openstack-doc18:10
*** pblaho has quit IRC18:12
*** thingee has joined #openstack-doc18:13
*** tosky has joined #openstack-doc18:13
thingeeildikov: going to start on the work for publishing the contributor guide. wondering what the url should be18:16
thingeeildikov: https://docs.openstack.org/contributor-guide ?18:17
thingeeanyone in this channel have an opinion?18:17
thingeeam I understanding right that the post jobs for publishing docs is leaning on the instructions with tox?18:18
*** yamamoto has quit IRC18:19
AJaegerthingee: by default repos publish to docs.openstack.org/REPO/latest/18:21
AJaegerthingee: that's done with the usual sphinx build - like cinder or nova does18:22
AJaegerI suggest to do the same here as well and not invent anything new18:22
thingeeAJaeger: sounds perfect18:23
*** catintheroof has joined #openstack-doc18:33
*** gouthamr has quit IRC18:47
*** AJaeger has quit IRC19:10
*** gouthamr has joined #openstack-doc19:22
*** gouthamr_ has joined #openstack-doc19:24
*** gouthamr has quit IRC19:26
ildikovthingee: sorry, I was flying19:38
ildikovthingee: reading back I agree with AJaeger too :)19:39
thingeeildikov: yup, it has already been posted for review https://review.openstack.org/#/c/51194619:41
ildikovthingee: awesome!!! Thanks! :)19:42
thingeedhellmann: do you have a second to answer a question about sphinx with the contributor guide project.19:42
thingee?19:43
dhellmannthingee : I can try19:43
dhellmannthingee : regarding the "contributor-guide" name, you'll want to make sure that doesn't conflict with the old name of the doc team contributor guide19:43
dhellmannI *think* that was contrib-guide but I'm not 100% sure19:44
thingeedhellmann: yes thank you, I'm aware of having to help there.19:44
dhellmanntoday there's a redirect from the old name to the new, let me look for that19:44
dhellmannredirectmatch 301 ^/contributor-guide/(.*)$ /doc-contrib-guide/$119:44
dhellmannso you don't want to call it "contributor-guide" I think19:45
dhellmannmaybe just "contributing"?19:45
thingeedang.19:45
dhellmannsorry19:45
dhellmannor we could decide not to redirect, I guess? something to discuss with pkovar19:45
thingeeyeah, I think the name indicates some general contributor guide. Later you figure it out it's doc specific.19:45
thingeethat definitely halts things. I'll have to go back to that when I have mind unwrapped with this other question.19:46
dhellmannyeah, the doc guide is now at /doc-contrib-guide for that reason19:46
thingeedhellmann: ok, I'll bring it up on the list.19:47
dhellmannI derailed you; did you have another sphinx question?19:49
thingeedhellmann: 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
thingeeso now comes the question of how exactly we accomplish that.19:49
dhellmannmy 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 repos19:50
dhellmannso you have the "here's a lot of general info about contributing to openstack" guide and the "here's how you contribute to zaqar" guide19:50
dhellmannthat 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 effective19:53
thingeedhellmann: 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.yaml19:53
thingeethe 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
thingeeshould verify that it actually exists in projects yaml? or pull it from projects yaml directly maybe19:54
thingeeembedding a url like that could be phishy19:55
dhellmannthe docs repo has info about which projects have contributor docs19:56
dhellmannso we could pull it from there, if we want to do it automatically19:56
dhellmannbut we could also just make the list manually19:56
dhellmann*or* the link in the guide you're building could link to a page in the openstack-manuals repo that is built automatically19:56
dhellmannthat wouldn't involve pulling data from yaml files across repos during builds19:57
thingeedhellmann: 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-guide19:57
dhellmannah, I see, sure19:57
dhellmannin that case you'll want to consume the yaml file(s) in the openstack-manuals repo19:57
dhellmannhttps://docs.openstack.org/doc-contrib-guide/doc-tools/template-generator.html has details on that file format19:58
dhellmannand I'm happy to help explain that in more detail if it's not sufficient19:58
thingeealso 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
dhellmannoh, hmm, I thought we had a flag for "has_contrib_guide" but we don't19:58
dhellmannsure, that makes sense too19:59
dhellmannugh, 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
thingeedhellmann: yikes, good luck. Thanks for showing me this template generator. This could lead me in the right direction.20:00
thingeeif anyone else in this channel has ideas, please let me know. Going to have some lunch now. :)20:01
*** AJaeger has joined #openstack-doc20:19
*** KeithMnemonic1 has quit IRC20:19
*** AJaeger has quit IRC20:20
*** thorst has quit IRC20:23
*** thorst has joined #openstack-doc20:23
*** thorst has quit IRC20:28
*** thorst has joined #openstack-doc20:44
*** edmondsw has quit IRC20:45
*** thorst has quit IRC20:48
*** catintheroof has quit IRC21:10
*** dustins has quit IRC21:28
*** thorst has joined #openstack-doc21:38
*** thorst has quit IRC21:42
*** tpsilva has quit IRC22:10
*** egallen has quit IRC22:20
*** gouthamr_ has quit IRC22:23
*** eumel8 has quit IRC23:20
*** gouthamr has joined #openstack-doc23:30
*** gouthamr_ has joined #openstack-doc23:43
*** gouthamr has quit IRC23:46
*** gouthamr_ has quit IRC23:57

Generated by irclog2html.py 2.15.3 by Marius Gedminas - find it at mg.pov.lt!