Thursday, 2017-10-19

*** masaki has joined #openstack-doc00:02
*** yamamoto has joined #openstack-doc00:05
*** hyakuhei has joined #openstack-doc00:12
*** gouthamr has joined #openstack-doc00:20
*** yangyapeng has quit IRC00:21
*** yangyapeng has joined #openstack-doc00:22
*** yangyapeng has quit IRC00:27
*** thorst has joined #openstack-doc00:31
*** suyog has joined #openstack-doc00:40
*** salv-orlando has joined #openstack-doc00:43
*** salv-orlando has quit IRC00:47
*** thorst has quit IRC00:57
*** emagana has quit IRC00:58
*** phuongnh has joined #openstack-doc01:12
*** yangyape_ has joined #openstack-doc01:21
*** thorst has joined #openstack-doc01:23
*** masayukig has quit IRC01:28
*** masayukig has joined #openstack-doc01:29
*** thorst has quit IRC01:36
*** salv-orlando has joined #openstack-doc01:44
*** salv-orlando has quit IRC01:49
*** thorst has joined #openstack-doc02:37
*** thorst has quit IRC02:42
*** salv-orlando has joined #openstack-doc02:45
*** salv-orlando has quit IRC02:49
*** gouthamr has quit IRC02:57
*** phuongnh has quit IRC03:25
*** phuongnh has joined #openstack-doc03:26
*** thorst has joined #openstack-doc03:38
*** thorst has quit IRC03:46
*** salv-orlando has joined #openstack-doc03:46
*** salv-orlando has quit IRC03:50
*** emagana has joined #openstack-doc04:15
*** phuongnh has quit IRC04:21
*** phuongnh has joined #openstack-doc04:21
*** salv-orlando has joined #openstack-doc04:47
*** salv-orlando has quit IRC04:51
*** salv-orlando has joined #openstack-doc05:03
openstackgerritMerged openstack/openstack-manuals master: [www] Remove WIP note for pike deploy index  https://review.openstack.org/51265905:29
*** thorst has joined #openstack-doc05:42
*** thorst has quit IRC05:47
*** spectr has joined #openstack-doc05:48
*** alex_xu has quit IRC05:54
*** alex_xu has joined #openstack-doc06:00
*** emagana has quit IRC06:17
*** suyog has quit IRC06:25
*** salv-orlando has quit IRC06:26
*** salv-orlando has joined #openstack-doc06:26
*** salv-orlando has quit IRC06:30
openstackgerritChason Chan proposed openstack/openstack-manuals master: Update User Guides list  https://review.openstack.org/51327706:45
openstackgerritChason Chan proposed openstack/openstack-manuals master: Update Admin Guides list  https://review.openstack.org/51328006:54
*** pcaruana has joined #openstack-doc06:55
*** eumel8 has joined #openstack-doc06:57
openstackgerritChason Chan proposed openstack/openstack-manuals master: Update User Guides list  https://review.openstack.org/51327707:02
*** tesseract has joined #openstack-doc07:21
*** salv-orlando has joined #openstack-doc07:26
*** salv-orlando has quit IRC07:31
*** jpena|off is now known as jpena07:31
*** salv-orlando has joined #openstack-doc07:42
eumel8chason: just wondering. checkbuild failed in your second proposal07:43
*** thorst has joined #openstack-doc07:43
*** thorst has quit IRC07:47
*** efoley has joined #openstack-doc08:27
*** yamamoto has quit IRC08:32
*** spectr has quit IRC08:47
*** spectr has joined #openstack-doc08:48
*** spectr has quit IRC08:48
*** spectr has joined #openstack-doc08:50
*** masaki has quit IRC09:02
chasoneumel8 Realy? I'm just back to my computer. :P09:13
*** yamamoto has joined #openstack-doc09:13
eumel8hi chason :)09:15
eumel8just reviewed roughly your proposals09:15
chasoneumel8 hey o/09:16
*** phuongnh has quit IRC09:16
chasoneumel8 Thanks for your review. :D09:17
*** phuongnh has joined #openstack-doc09:17
*** tosky has joined #openstack-doc09:17
chasoneumel8 I got it, see http://logs.openstack.org/77/513277/2/check/build-tox-manuals-checkbuild/1aba8cf/job-output.txt.gz#_2017-10-19_07_13_22_56236609:18
eumel8maybe an additional variable check is required09:18
eumel8in both09:18
chasonI shoud change "for project in projects|sort(attribute='deployment'" to "for project in projects|sort(attribute='service""09:20
*** salv-orlando has quit IRC09:21
openstackgerritChason Chan proposed openstack/openstack-manuals master: Update User Guides list  https://review.openstack.org/51327709:22
*** salv-orlando has joined #openstack-doc09:22
eumel8if attribute='services' all time exists, yes09:23
*** sambetts|afk is now known as sambetts09:24
openstackgerritMerged openstack/openstack-manuals master: highlight variables in sample links and paths  https://review.openstack.org/51314709:25
openstackgerritMerged openstack/openstack-manuals master: document has_deployment_guide flag  https://review.openstack.org/51314809:25
*** salv-orlando has quit IRC09:27
*** thorst has joined #openstack-doc09:44
*** thorst has quit IRC09:49
*** yamamoto has quit IRC09:49
*** salv-orlando has joined #openstack-doc10:21
*** pbourke has quit IRC10:29
*** pbourke has joined #openstack-doc10:31
*** yamamoto has joined #openstack-doc10:50
*** yamamoto has quit IRC10:53
*** yamamoto has joined #openstack-doc10:53
*** yamamoto has quit IRC10:53
*** jpena is now known as jpena|lunch10:59
*** yangyape_ has quit IRC11:01
*** yamamoto has joined #openstack-doc11:02
*** phuongnh has quit IRC11:02
*** tpsilva has joined #openstack-doc11:16
*** nicolasbock has joined #openstack-doc11:32
*** nicolasbock has quit IRC11:38
*** nicolasbock has joined #openstack-doc11:50
*** edmondsw has joined #openstack-doc11:51
*** salv-orlando has quit IRC11:54
*** rcernin has joined #openstack-doc11:58
*** jpena|lunch is now known as jpena12:02
*** pkovar has joined #openstack-doc12:05
*** thorst has joined #openstack-doc12:13
*** salv-orlando has joined #openstack-doc12:15
*** catintheroof has joined #openstack-doc12:27
*** yangyapeng has joined #openstack-doc12:29
*** catintheroof has quit IRC12:42
*** pblaho has quit IRC12:43
*** bbbbzhao_ has joined #openstack-doc12:44
*** pblaho has joined #openstack-doc12:45
*** pkovar has quit IRC12:45
*** catintheroof has joined #openstack-doc12:51
*** catintheroof has quit IRC12:53
*** pkovar has joined #openstack-doc12:56
*** dustins has joined #openstack-doc13:02
stephenfindhellmann: If I go to https://docs.openstack.org/nova/latest/user/flavors, things work. If I add a trailing '/', things do not work. Is that expected?13:13
*** rcernin has quit IRC13:21
dhellmannstephenfin : flavors is a .rst file so I would expect you to need to add .html to the end and for a trailing slash to not work. I'm not sure why leaving off the .html works.13:29
*** rcernin has joined #openstack-doc13:35
*** rcernin has quit IRC13:40
*** eumel8 has quit IRC13:42
*** gouthamr has joined #openstack-doc14:20
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: add more detail to template generator page  https://review.openstack.org/51308714:27
*** donghao has joined #openstack-doc14:30
*** donghao has quit IRC14:36
*** donghao has joined #openstack-doc14:38
*** spectr has quit IRC14:38
*** donghao has quit IRC14:41
*** donghao has joined #openstack-doc14:42
jungleboyjpkovar:  I have a conflict today so I won't be able to make the docs team meeting.14:43
pkovarjungleboyj: thanks for the info. if there's anything you want me to mention in the mtg, let me know14:47
jungleboyjI have gotten the Cinder docs moved to use 'Install Guide' instead of 'Install Tutorial'.14:48
jungleboyjWe are making progress on the install guide testing.14:48
jungleboyjpkovar: ^  That is about it.14:48
pkovarjungleboyj: out of curiosity, do you track your progress somewhere? I'd like to update others at the summit forum about the progress people are making14:50
jungleboyjI haven't been.  I probably should.14:50
pkovar(we also have https://wiki.openstack.org/wiki/Documentation/PikeDocTesting#Installation_Guide)14:50
pkovarfeel free to use that page, if you like :)14:51
jungleboyjIf you have that I can track there.14:51
pkovarjungleboyj: that would be great, thanks14:51
*** yamamoto has quit IRC14:54
stephenfindhellmann: Ah, so we're not using the dirhtml builder?14:57
dhellmannstephenfin : I don't think so?14:58
stephenfinThat makes sense. Wonder how the '.html' extensions are getting stripped off so. Presumably Apache rewriting on infra's side14:58
dhellmannstephenfin : no, on the server filesystem I definitely see a flavors.html14:59
dhellmannyeah, probably an extension14:59
dhellmannstephenfin : https://docs.openstack.org/infra/system-config/afs.html15:00
stephenfindhellmann: Oh, is docs.o.o not served with Apache?15:02
stephenfinor am I misunderstanding something?15:02
dhellmannstephenfin : it is. those are instructions for setting up a client so you can look at the files.15:02
dhellmannyou can connect as a read-only client to the afs filesystem used to hold the content15:02
stephenfinahhhh - gotcha15:03
*** nicolasbock has quit IRC15:17
*** nicolasbock has joined #openstack-doc15:18
*** nicolasbock has quit IRC15:22
pkovarall: docs meeting starts in ~ 12 mins15:48
pkovarin #openstack-meeting15:48
pkovaras always15:48
*** eumel8 has joined #openstack-doc15:50
*** yamamoto has joined #openstack-doc15:55
*** bsilverman has joined #openstack-doc15:57
pkovar2 mins15:58
*** ianychoi has quit IRC16:06
*** ianychoi has joined #openstack-doc16:07
*** yamamoto has quit IRC16:11
*** salv-orl_ has joined #openstack-doc16:11
*** salv-orlando has quit IRC16:14
*** pcaruana has quit IRC16:18
*** dustins has quit IRC16:27
*** bsilverman has left #openstack-doc16:29
*** donghao has quit IRC16:35
*** yamamoto has joined #openstack-doc16:39
*** jpena is now known as jpena|off16:52
*** yamamoto has quit IRC16:53
pkovar#topic sitemap automation suggestions17:00
pkovar;)17:00
dhellmannheh17:00
dhellmannI don't see mguiney or jamesmcarthur in channel, and it's lunchtime here17:01
dhellmannmaybe this is a good ML topic17:01
*** mguiney has joined #openstack-doc17:01
mguineyo/17:02
dhellmannhi!17:03
dhellmannso, I was asking whether the current tool is the best tool to manage the sitemap files17:03
dhellmannone failing it has is that it requires manual review of the results (even if we automate submitting the patch)17:03
mguineyahhhh17:04
*** jamesmcarthur has joined #openstack-doc17:04
*** sambetts is now known as sambetts|afk17:04
mguineythat is interesting, certainly. I somehow missed that it still requires actual manual patch review17:04
dhellmannso ideally we'd just have a sitemap file produced every time a doc build publishes content, without extra work17:04
*** tesseract has quit IRC17:04
dhellmannright, today you run the tool by hand and then propose the patch by hand17:04
* mguiney nods17:04
dhellmannwe could potentially automatically publish the results, I guess17:05
mguineyOk. So maybe bypassing the patch process altogether would be a good idea, if we could find a way for it just to refresh based on a trigger17:05
dhellmannbut why wait to generate the site map as a separate step?17:05
dhellmannif we use a sitemap index, we could have a separate sitemap file in each doc build17:05
dhellmannand that per-doc sitemap file could be generated by the publish job17:06
dhellmannit would only include the content for that job, but the index file would let the search engines put them all together17:06
dhellmannmake sense?17:07
jamesmcarthurWhat's teh overhead look like to create a sitemap?17:07
dhellmannscraping the whole docs.o.o site takes ages. making a list of the files published in a given doc job is very fast.17:07
dhellmanna sitemap file can literally be a list of URLs. We can do that with a bash script.17:08
mguiney^ that, of course was another one of the goals17:08
mguineymore targeted crawling = faster generation = more dynamic sitemaps17:08
dhellmannthe index file needs to be XML, still, I think, but we can generate that with a template, too17:08
jamesmcarthurYeah, so doing it on publication would make sense. We'd need a way to remove docs from the sitemap as well.17:09
mguineyscrapy, if we do continue using it, has a utility for that17:09
dhellmannwe don't even need to crawl. a command like this would do it: find docs/build/html -name '*.html' | sed -e "s|^|$URL_PREFIX/|"17:09
dhellmannevery time we publish, we generate a new sitemap for the subtree being published17:10
mguineyah. right. sorry, this is something of a new domain, to me17:10
dhellmannthen every time we publish from openstack-manuals, we generate a new sitemap index file17:10
jamesmcarthurdhellman - i like this plan17:10
jamesmcarthursorry - i left off an n17:10
dhellmannmaybe the next steps then are for mguiney to look at the sitemap format specs and make sure I'm not talking nonsense about what's possible and to look at the publishing jobs to see how those work so we can figure out where to add this new step.17:11
dhellmannI don't know what those jobs look like after the zuulv3 migration, so I'll need to come up to speed on those, too17:12
*** bbbbzhao_ has quit IRC17:12
dhellmannthen we can start formulating a more detailed plan and write it up as a spec17:13
mguineyI can do that, cool!17:13
dhellmannexcellent, thanks mguiney17:13
dhellmannI'm usually here in channel during us/eastern tz work hours, if I can help with pointers.17:14
jamesmcarthurthanks dhellmann!17:14
mguineyawesome. I may very well ping you with questions :)17:14
dhellmannI hope to have answers :-)17:14
jamesmcarthurthanks mguiney for working on this! I think it's going to be cool.17:16
*** jamesmcarthur has quit IRC17:16
*** jamesmcarthur has joined #openstack-doc17:17
* dhellmann goes off to find nourishment17:18
*** jamesmcarthur has quit IRC17:22
*** fragatina has quit IRC17:23
*** jamesmcarthur has joined #openstack-doc17:25
*** salv-orlando has joined #openstack-doc17:25
*** salv-orl_ has quit IRC17:29
*** salv-orlando has quit IRC17:30
*** tosky has quit IRC17:36
*** pblaho has quit IRC17:41
*** aspiers[m] has quit IRC17:44
*** jamesmcarthur has quit IRC17:52
*** jamesmcarthur has joined #openstack-doc17:52
*** jamesmcarthur has quit IRC17:57
*** efoley has quit IRC18:04
*** tosky has joined #openstack-doc18:04
*** jamesmcarthur has joined #openstack-doc18:08
*** phil_h has joined #openstack-doc18:20
*** pkovar has quit IRC18:30
*** salv-orlando has joined #openstack-doc19:05
*** pkovar has joined #openstack-doc19:11
*** nicolasbock has joined #openstack-doc19:18
*** jamesmcarthur has quit IRC19:22
*** jamesmcarthur has joined #openstack-doc19:22
*** jamesmcarthur has quit IRC19:27
*** jamesmcarthur has joined #openstack-doc19:32
*** eumel8 has quit IRC19:46
*** salv-orl_ has joined #openstack-doc19:46
*** salv-orlando has quit IRC19:49
*** nicolasbock has quit IRC19:49
*** jamesmcarthur has quit IRC19:53
*** jamesmcarthur has joined #openstack-doc19:54
*** nicolasbock has joined #openstack-doc19:55
*** phil_h has quit IRC19:56
*** nicolasbock has quit IRC20:00
*** nicolasbock has joined #openstack-doc20:09
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: add more detail to template generator page  https://review.openstack.org/51308720:13
*** nicolasbock has quit IRC20:14
*** nicolasbock has joined #openstack-doc20:15
*** nicolasbock has quit IRC20:23
*** nicolasbock has joined #openstack-doc20:37
*** pkovar has quit IRC21:04
*** gouthamr has quit IRC21:15
*** thorst has quit IRC21:16
*** thorst has joined #openstack-doc21:18
*** thorst has quit IRC21:23
*** jamesmcarthur has quit IRC21:24
*** suyog has joined #openstack-doc21:27
*** tosky has quit IRC21:36
openstackgerritMike Perez proposed openstack/contributor-guide master: Updating README with correct tox instructions  https://review.openstack.org/51352921:41
*** tpsilva has quit IRC21:42
*** thorst has joined #openstack-doc21:47
*** yamamoto has joined #openstack-doc21:50
*** thorst has quit IRC21:51
*** aspiers[m] has joined #openstack-doc22:00
openstackgerritMerged openstack/contributor-guide master: Updating README with correct tox instructions  https://review.openstack.org/51352922:15
*** thorst has joined #openstack-doc22:23
*** fragatina has joined #openstack-doc22:23
*** thorst_ has joined #openstack-doc22:26
*** thorst has quit IRC22:27
*** thorst_ has quit IRC22:30
*** jamesmcarthur has joined #openstack-doc22:39
*** jamesmcarthur has quit IRC22:43
*** thorst has joined #openstack-doc23:07
*** dmacpher has quit IRC23:09
*** s-shiono has joined #openstack-doc23:54

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