Tuesday, 2017-07-11

*** oanson has joined #openstack-doc00:01
*** masaki has joined #openstack-doc00:02
*** gmann has quit IRC00:11
*** gmann has joined #openstack-doc00:11
*** tosky has quit IRC00:28
*** annegentle has joined #openstack-doc00:29
*** dfflanders has joined #openstack-doc00:29
*** thorst has quit IRC00:45
*** edmondsw has joined #openstack-doc00:49
*** edmondsw has quit IRC00:53
*** oanson has quit IRC00:54
*** oanson has joined #openstack-doc00:56
*** annegentle has quit IRC01:19
*** thorst has joined #openstack-doc01:28
*** thorst has quit IRC01:28
openstackgerritMerged openstack/security-doc master: Rework the 'node hardening' section  https://review.openstack.org/48223101:29
openstackgerritMerged openstack/openstack-manuals master: link to in-tree API documentation  https://review.openstack.org/48218801:36
*** bsilverman_ has quit IRC01:37
*** annegentle has joined #openstack-doc01:38
*** bsilverman_ has joined #openstack-doc01:38
*** charcol has quit IRC01:38
*** annegentle has quit IRC01:39
*** charcol has joined #openstack-doc01:39
*** tonytan_brb has joined #openstack-doc01:49
*** caoyuan has joined #openstack-doc01:50
*** tonytan4ever has quit IRC01:52
*** dmacpher has joined #openstack-doc02:08
*** edmondsw has joined #openstack-doc02:37
*** edmondsw has quit IRC02:42
*** caoyuan_ has joined #openstack-doc02:51
*** caoyuan has quit IRC02:54
*** tonytan_brb has quit IRC02:58
*** yamamoto has joined #openstack-doc02:58
*** tonytan4ever has joined #openstack-doc03:28
*** thorst has joined #openstack-doc03:29
*** dmacpher has quit IRC03:29
*** dmacpher has joined #openstack-doc03:33
*** thorst has quit IRC03:34
*** emagana has joined #openstack-doc03:41
*** fragatin_ has joined #openstack-doc03:51
*** fragatin_ has quit IRC03:52
*** fragatin_ has joined #openstack-doc03:52
*** fragatina has quit IRC03:54
*** tonytan4ever has quit IRC03:57
*** fragatin_ has quit IRC03:57
*** cathrich_ has joined #openstack-doc03:58
*** cathrichardson has quit IRC03:58
*** fragatina has joined #openstack-doc04:05
*** fragatina has quit IRC04:09
*** adreznec has quit IRC04:13
*** adreznec has joined #openstack-doc04:14
*** emagana has quit IRC04:23
*** emagana has joined #openstack-doc04:24
*** edmondsw has joined #openstack-doc04:25
*** emagana_ has joined #openstack-doc04:26
*** emagana has quit IRC04:28
*** edmondsw has quit IRC04:30
*** emagana_ has quit IRC04:31
*** emagana has joined #openstack-doc04:32
*** emagana has quit IRC04:36
AJaegernotmyname: you can have a link from x to y - a static one, update openstack-manuals/www/.htaccess and add one.04:58
notmynamefor a custom 404?04:58
notmynameor for a redirect?04:59
notmynameI realized that the plan is in fact to break the existing links05:00
AJaegerfor a redirect05:03
AJaegeryes, those are already broken - changes are too massive overall05:04
openstackgerritMerged openstack/openstack-manuals master: add libraries to list of configuration reference guides  https://review.openstack.org/48226305:15
openstackgerritMerged openstack/openstack-manuals master: remove the cli-ref from openstack-manuals  https://review.openstack.org/48109205:15
openstackgerritMerged openstack/openstack-manuals master: remove links to cli-reference from template pages  https://review.openstack.org/48109605:15
openstackgerritMerged openstack/openstack-manuals master: redirect cli-reference to python-openstackclient  https://review.openstack.org/48222005:15
*** cathrich_ has quit IRC05:15
*** cathrichardson has joined #openstack-doc05:17
*** d0ugal has joined #openstack-doc05:22
*** thorst has joined #openstack-doc05:30
*** thorst has quit IRC05:34
*** amotoki_away is now known as amotoki05:35
*** ianychoi has joined #openstack-doc05:40
*** rcernin has joined #openstack-doc05:41
*** katyafervent_awa has quit IRC05:44
*** katyafervent_awa has joined #openstack-doc05:44
*** d0ugal has quit IRC05:52
*** nicolasbock has joined #openstack-doc05:55
*** masaki has quit IRC06:02
*** masaki has joined #openstack-doc06:02
*** pcaruana has joined #openstack-doc06:04
*** edmondsw has joined #openstack-doc06:14
*** edmondsw has quit IRC06:18
openstackgerritOpenStack Proposal Bot proposed openstack/security-doc master: Imported Translations from Zanata  https://review.openstack.org/48241806:40
*** emagana has joined #openstack-doc06:44
*** belmoreira has joined #openstack-doc06:46
*** emagana has quit IRC06:48
*** suyog has quit IRC06:49
*** egallen has joined #openstack-doc06:49
*** tesseract has joined #openstack-doc07:02
*** dfflanders has quit IRC07:18
*** jpena|off is now known as jpena07:19
*** fragatina has joined #openstack-doc07:27
*** mriedem has quit IRC07:30
openstackgerritOpenStack Proposal Bot proposed openstack/training-guides master: Imported Translations from Zanata  https://review.openstack.org/48243207:31
*** thorst has joined #openstack-doc07:31
*** egallen has quit IRC07:32
*** fragatina has quit IRC07:32
*** openstackgerrit has quit IRC07:33
*** thorst has quit IRC07:36
*** egallen has joined #openstack-doc08:07
*** openstackgerrit has joined #openstack-doc08:52
openstackgerritRob Cresswell proposed openstack/openstackdocstheme master: Add support for versionadded and deprecated  https://review.openstack.org/48226508:52
*** phuongnh has joined #openstack-doc08:56
*** tosky has joined #openstack-doc08:59
*** masaki has quit IRC09:02
*** vijaykc4 has joined #openstack-doc09:15
*** thorst has joined #openstack-doc09:32
*** Aqsa has joined #openstack-doc09:35
*** thorst has quit IRC09:37
*** edmondsw has joined #openstack-doc09:50
*** vijaykc4 has quit IRC09:50
*** vijaykc4 has joined #openstack-doc09:51
*** d0ugal has joined #openstack-doc09:52
*** edmondsw has quit IRC09:54
*** d0ugal has quit IRC09:59
*** yamamoto has quit IRC10:03
*** vijaykc4 has quit IRC10:04
*** caoyuan_ has quit IRC10:05
*** phuongnh has quit IRC10:08
Aqsaasettle: Can you kindly tell me where the code for wiki page of OpenStack is hosted?10:22
openstackgerritRob Cresswell proposed openstack/openstackdocstheme master: Add support for versionadded and deprecated  https://review.openstack.org/48226510:25
*** gouthamr has quit IRC10:33
*** gouthamr has joined #openstack-doc10:41
*** egallen has quit IRC10:44
*** egallen has joined #openstack-doc10:44
*** egallen has quit IRC10:44
*** egallen has joined #openstack-doc10:45
*** egallen has quit IRC10:45
*** egallen has joined #openstack-doc10:46
*** egallen has quit IRC10:46
*** egallen has joined #openstack-doc10:46
*** egallen has quit IRC10:47
*** egallen has joined #openstack-doc10:47
*** egallen has quit IRC10:48
*** thorst has joined #openstack-doc10:50
*** pkovar has joined #openstack-doc10:57
toskyapart from this: https://review.openstack.org/#/c/474543/ there are other examples of import/migration of configuration reference?11:03
AJaegerAqsa: what exactly do you need?11:03
*** vijaykc4 has joined #openstack-doc11:03
*** yamamoto has joined #openstack-doc11:04
AJaegertosky: whenever I see such patches I chagne the topic to doc-migration ;)11:06
AJaegertosky looking through doc-migration I spoted https://review.openstack.org/#/c/478597/ and https://review.openstack.org/#/c/473560/11:08
AJaegertosky: and then I asked gerrit, like https://review.openstack.org/#/q/topic:doc-migration+file:doc/source/configuration/index.rst11:09
*** yamamoto has quit IRC11:11
*** vijaykc4 has quit IRC11:13
toskyAJaeger: thanks - I tried to go through the patches marked as doc-migration, but I failed to find many with "config" in the subject11:17
toskyand I didn't know about file: as search filter11:18
AJaegeryeah, file is really cool in this context ;)11:20
*** vijaykc4 has joined #openstack-doc11:23
*** yamamoto has joined #openstack-doc11:30
*** egallen has joined #openstack-doc11:32
*** edmondsw has joined #openstack-doc11:38
*** edmondsw has quit IRC11:42
*** vijaykc4 has quit IRC11:45
*** vijaykc4 has joined #openstack-doc12:01
AqsaAJaeger: The operations guide has to be moved to wiki page. I am not sure where exactly this change will have to be merged.12:03
*** vijaykc4 has quit IRC12:06
*** vijaykc4 has joined #openstack-doc12:06
*** dustins has joined #openstack-doc12:09
*** caoyuan has joined #openstack-doc12:10
AJaegerAqsa: that's what the person doing the migration has to come up with http://wiki.openstack.org/ is the wiki - and uses mediawiki, so adding content is done via a browser12:12
*** jpena is now known as jpena|lunch12:16
*** pkovar has quit IRC12:35
openstackgerritMerged openstack/openstack-manuals master: use the governance data to build the redirect list for /latest/  https://review.openstack.org/48117212:35
*** yamamoto has quit IRC12:38
*** caoyuan_ has joined #openstack-doc12:41
*** caoyuan has quit IRC12:41
*** edmondsw has joined #openstack-doc12:46
*** openstackgerrit has quit IRC12:47
*** charcol has quit IRC12:59
*** charcol has joined #openstack-doc12:59
*** vijaykc4 has quit IRC13:00
*** vijaykc4 has joined #openstack-doc13:00
*** matjazp has joined #openstack-doc13:02
*** pkovar has joined #openstack-doc13:02
*** cathrich_ has joined #openstack-doc13:13
*** cathrichardson has quit IRC13:16
*** emagana has joined #openstack-doc13:19
*** emagana has quit IRC13:24
*** yamamoto has joined #openstack-doc13:25
*** jpena|lunch is now known as jpena13:27
*** fragatina has joined #openstack-doc13:28
*** alexchadin has joined #openstack-doc13:29
*** fragatina has quit IRC13:33
mpranjichello13:34
mpranjicman, it is weird going to vacation... takes some time to get the strings back :)13:35
*** fragatina has joined #openstack-doc13:36
*** fragatina has quit IRC13:36
*** fragatina has joined #openstack-doc13:36
dhellmannnotmyname : links to /developer/swift/.* should be redirecting to /swift/latest/ but they won't necessarily go directly to the page in question because we can't predict where that will be (some of the content under /developer/$project moves to the install directory, some to contributor, etc.). If you have a redirect that's not working as expected, let me know and I'll see if I can work out why.13:39
mpranjicAJaeger: reviews will be done for wiki code too?13:41
dhellmannmpranjic : the proposal was for the operator community to take ownership of the operators' guide and move it to the wiki. The process for doing that will be up to the people who volunteer to do it.13:43
amotokidhellmann: asettle: do we need to apply the doc-migration work to openstack-dev projects like hacking?13:43
dhellmannasettle , AJaeger : o/13:43
dhellmannamotoki : eventually it would be good to do that, but they are less of a priority than other the projects13:43
dhellmanns/other the/the other/13:44
amotokiat now, /developer/hacking and /hacking/latest are both dead13:44
dhellmannwe probably haven't landed a patch in that repo13:44
dhellmannI'm going to work with fungi this week or next week to move any old html from /developer for projects that have nothing under the new structure13:45
dhellmannamotoki : https://review.openstack.org/48171013:45
amotokiI was asked whether we should update the hacking url when reviewing a patch to update URLs in README or similar thing13:45
dhellmannyes, that probably makes sense to do. we left out the step to update URLs in README files.13:46
*** egallen has quit IRC13:47
amotokidhellmann: thanks. it makes sense, but it seems better not to rush sending a patch of updating doc URLs13:47
*** egallen has joined #openstack-doc13:47
*** egallen has quit IRC13:48
*** egallen has joined #openstack-doc13:48
*** egallen has quit IRC13:48
mpranjicdhellmann: makes sense13:49
dhellmannamotoki : yes, I agree. We do have redirects in place.13:49
*** egallen has joined #openstack-doc13:49
mpranjicI am doing wiki on several projects for years. I can help.13:49
*** egallen has quit IRC13:49
dhellmannmpranjic: that would be good. you probably want to coordinate with asettle; I'm not sure if anyone else has volunteered so far.13:49
*** egallen has joined #openstack-doc13:50
*** egallen has quit IRC13:50
*** egallen has joined #openstack-doc13:50
*** gcb has joined #openstack-doc13:51
mpranjicasettle: ! :)13:51
mpranjicdhellmann: will do thnx.13:51
*** egallen has quit IRC13:51
*** egallen has joined #openstack-doc13:51
mpranjicI am on vacation atm. a bit wild here with limited access, but can start slowly soon, I think13:51
*** egallen has quit IRC13:52
*** egallen has joined #openstack-doc13:52
*** egallen has quit IRC13:52
*** egallen has joined #openstack-doc13:53
*** egallen has quit IRC13:53
*** d0ugal has joined #openstack-doc13:54
*** egallen has joined #openstack-doc13:54
*** egallen has quit IRC13:54
AJaegermpranjic: there'S no wiki *code*. And a wiki comes without reviews.13:55
AJaegermpranjic: there was some email on openstack-ops mailing list, best to follow up there (last month?)13:56
*** openstackgerrit has joined #openstack-doc14:00
openstackgerritHelen Walsh proposed openstack/openstack-manuals stable/ocata: VMAX driver - typo fixes and clarification to Ocata manuals  https://review.openstack.org/48257514:00
*** d0ugal has quit IRC14:00
*** rbowen has quit IRC14:01
asettlempranjic: here now! Sorry, was in transit today14:02
asettledhellmann and AJaeger - mpranjic did email me a while back volunteering, which I forwarded to the ops list. There was one other individual who offered to help in a patch14:02
asettleI'd have ot go back and have a look and find14:02
*** rbowen has joined #openstack-doc14:03
gcbdhellmann:  should we finish the work of ' update the link to the documentation in your README, setup.cfg and other documentations to point to the new location' for oslo before next week ?14:03
mpranjicAJaeger: I thought as much. just wanted to double-check what wasa the idea14:06
mpranjicasettle: I was busy with some projects and vas drawn into the deserted places (vacation time), so I lag a bit14:07
mpranjicbut it will get better :)14:07
AJaegerasettle: Aqsa was asking earlier as well14:11
mpranjicdo we have some timeline, deadline or anything similar?14:13
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: link to list of api guides from main page  https://review.openstack.org/48257814:17
asettleAJaeger and mpranjic just on a meeting, but yes, the deadline is essentially Pike14:19
asettleWhich is last week August14:19
*** ykarel has joined #openstack-doc14:20
ykarelAJaeger, sorry didn't new about this channel14:20
AJaegerykarel: it was announced in dhellmann's updates about doc-migration work14:21
AJaegerykarel: your question is answered in http://specs.openstack.org/openstack/docs-specs/specs/pike/os-manuals-migration.html14:21
AJaeger"docs.openstack.org/$project-name/$series – build from stable/$series"14:21
dhellmanngcb : if we can, yes. but we should have redirects in place for those old doc locations so users will be able to find the documentation14:22
*** vijaykc4 has quit IRC14:22
AJaegerSo, ykarel so merge somethign to ocata or newton so that it gets published on https://docs.openstack.org/magnum/newton14:22
ykarelAJaeger, Ok got it14:22
ykarelThanks14:22
*** yamamoto has quit IRC14:24
gcbdhellmann: okay, I saw the the redirect works.  I will check and mark Done for oslo libraries in next days in https://etherpad.openstack.org/p/doc-migration-tracking14:24
dhellmanngcb : thank you!14:25
*** d0ugal has joined #openstack-doc14:25
*** d0ugal has quit IRC14:31
*** alexchadin has quit IRC14:32
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: add flags for a bunch of missing guides  https://review.openstack.org/48231414:36
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: add a new landing page to list all admin guides  https://review.openstack.org/48231514:36
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: add flag to www-generator to look for links to enable  https://review.openstack.org/48231314:36
*** rcernin has quit IRC14:38
*** yamamoto has joined #openstack-doc14:40
*** rcernin has joined #openstack-doc14:40
*** jpena is now known as jpena|off14:46
*** openstackgerrit has quit IRC14:48
*** openstackgerrit has joined #openstack-doc14:48
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: move config-reference.html to /configuration/  https://review.openstack.org/48258914:48
*** emagana has joined #openstack-doc14:49
*** cathrich_ is now known as cathrichardson15:00
*** jpena|off is now known as jpena15:13
*** rcernin has quit IRC15:18
*** caoyuan_ has quit IRC15:20
*** annegentle has joined #openstack-doc15:24
*** catintheroof has joined #openstack-doc15:28
jungleboyjdhellmann:  Good morning.  Quick question for you.15:30
dhellmannhi, jungleboyj, good morning15:30
jungleboyjdhellmann: I hadn't seen the config-reference in the list of things that I need to migrate but it appears that it was removed from openstack-manuals.15:31
openstackgerritMerged openstack/training-guides master: Imported Translations from Zanata  https://review.openstack.org/48243215:33
dhellmannjungleboyj : yes, the old static content should be replaced with pages using oslo.config's sphinxext module to generate tables automatically15:34
dhellmannjungleboyj : https://docs.openstack.org/oslo.config/latest/reference/sphinxext.html15:35
dhellmannjungleboyj : here's a patch from sjain for keystone: https://review.openstack.org/#/c/479631/15:35
*** belmoreira has quit IRC15:38
jungleboyjdhellmann:  Ok.  Thanks!  I will make a comparable change for Cinder.15:39
jungleboyjI vaguely remember reading about that somewhere.  Anything else that needs to be autogenerated that I might have missed?15:40
smcginnisdhellmann, jungleboyj: How is that automatically generated? The tables always were, but there was a lot of extra descriptions and notes for each driver.15:42
dhellmannjungleboyj : there's a similar extension for policy in oslo.policy (that keystone patch uses it, too, I think)15:43
jungleboyjOk.15:43
dhellmannsmcginnis : if there is useful extra *prose* content in the old guide, that should be copied over15:44
*** andreas_s has quit IRC15:44
setuidandreas_s: Remind me again when the switch from mvn to tox happened? Was that between liberty-eol and mitaka branches?15:44
dhellmannsmcginnis, jungleboyj: but the tables in that guide were produced through some automation that we're deprecating (along with the guide itself)15:44
smcginnisYeah, quite a bit of extra prose, for example: https://docs.openstack.org/ocata/config-reference/block-storage/drivers/emc-vmax-driver.html15:45
jungleboyjsmcginnis:  :-(15:45
dhellmannok. that stuff can all go into your /admin or /install guides now15:47
*** mhayden has quit IRC15:48
*** mhayden has joined #openstack-doc15:48
jungleboyjdhellmann:  Ok.15:51
jungleboyjsmcginnis:  That is going to take some more thought and effort to do.15:52
jungleboyjLets plan some time to talk about that when we get together tomorrow.15:52
*** yamamoto has quit IRC15:58
*** vijaykc4 has joined #openstack-doc16:04
*** ykarel has quit IRC16:04
*** ykarel has joined #openstack-doc16:05
*** mriedem has joined #openstack-doc16:11
*** annegentle has quit IRC16:13
*** amotoki is now known as amotoki_away16:14
*** annegentle has joined #openstack-doc16:17
*** edmondsw has quit IRC16:17
*** ykarel has quit IRC16:19
*** edmondsw_ has joined #openstack-doc16:19
*** edmondsw_ has quit IRC16:23
openstackgerritHelen Walsh proposed openstack/openstack-manuals stable/ocata: VMAX driver - typo fixes and clarification to Ocata manuals  https://review.openstack.org/48257516:50
*** yamamoto has joined #openstack-doc16:59
*** yamamoto has quit IRC17:04
*** pkovar has quit IRC17:10
*** jpena is now known as jpena|off17:13
*** jpena|off has quit IRC17:14
*** vijaykc4 has quit IRC17:27
*** edmondsw has joined #openstack-doc17:35
*** matjazp has quit IRC17:39
*** tosky has quit IRC17:41
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: move config-reference.html to /configuration/  https://review.openstack.org/48258917:43
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: link to list of api guides from main page  https://review.openstack.org/48257817:43
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: add validation requiring clients to have a description value  https://review.openstack.org/48227517:48
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: sort libraries by service description  https://review.openstack.org/48227717:48
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: shorten the shade description  https://review.openstack.org/48227617:48
*** Aqsa has quit IRC17:50
mordreddhellmann: ah - I see the thing you're solving now17:56
*** annegentle has quit IRC17:58
*** annegentle has joined #openstack-doc17:59
AJaegerdhellmann: I'll do a major surgery on .htaccess now - stay tuned...18:01
dhellmannmordred : with the description?18:02
dhellmannAJaeger : ack18:02
*** yamamoto has joined #openstack-doc18:02
*** tosky has joined #openstack-doc18:07
*** yamamoto has quit IRC18:07
openstackgerritAndreas Jaeger proposed openstack/openstack-manuals master: Remove old redirects from .htaccess  https://review.openstack.org/48265618:15
AJaegerdhellmann: ^18:16
AJaegersee alsoe the first 10 lines of the file, those are redirects for anything like /bexar - so not sense to move any bexar subdir around...18:17
dhellmanngood point18:18
*** vijaykc4 has joined #openstack-doc18:18
* AJaeger removes some duplicates - shortening the file showed this18:19
*** edmondsw_ has joined #openstack-doc18:23
*** tesseract has quit IRC18:25
*** edmondsw has quit IRC18:25
setuidOk, who broke the mitaka doc branch?18:31
setuid$ tox -e bindep18:31
setuidERROR: unknown environment 'bindep'18:31
setuidgrrr18:31
setuidThis was working 2 weeks ago18:31
AJaegersetuid: no18:31
AJaegerI doubt that we added bindep to mitaka, only to newer branches18:32
AJaegersetuid: are you sure you're on mitaka branch?18:32
setuidhrm.. ok, one sec18:32
setuidyep, on the mitaka branch18:32
setuidmitaka-eol18:32
AJaegerand we didn't merge anything to mitaka for some time...18:32
mpranjicasettle: well, we have a lot to do then :)18:33
openstackgerritAndreas Jaeger proposed openstack/openstack-manuals master: Remove old redirects from .htaccess  https://review.openstack.org/48265618:33
setuidAJaeger: I'm just trying to offer $CLIENT a solution to these missing docs18:33
setuidPulling a clean clone now18:33
AJaegersetuid: which missing *mitaka* docs?18:34
setuidAll the eol branches, have missing docs upstream, so I'm giving $CLIENT a temporary workaround by patching the branches to build local copoies18:34
setuidliberty-eol is patched and works, for building a local copy, working on mitaka now18:34
AJaegersetuid: we have all mitaka docs up18:35
AJaegerhttp://docs.openstack.org/mitaka/config-reference/ https://docs.openstack.org/mitaka/install-guide-ubuntu/ are both there18:35
setuidUnderstood, I'm working on a contingency plan, for when those get pulled (like liberty, kilo, etfc. did)18:35
setuidthe mitaka-eol branch has a tox.ini in it, so someone was building it with tox18:35
AJaegeryes, it has tox. but no bindep that was added later18:36
setuidOk, so there's another gap here. How does one build mitaka docs from that tag, since maven builds were deprecated?18:38
setuidThis page implies tox + bindep: https://docs.openstack.org/contributor-guide/docs-builds.html18:38
setuidSo there's some 'interim' build solution somewhere between mvn and tox?18:39
AJaegersetuid: just use tox, mitaka does not use maven18:39
*** annegentle has quit IRC18:39
setuidSo literally just run 'tox' in the clone?18:39
AJaegeryes18:39
setuidhrm, that's easy :)18:39
AJaegerif bindep on master tells you're fine, you should be fine for mitaka as well18:39
setuidLooks like some unstated deps are missing, I'll doc them and report it18:41
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: move admin-guide.html to admin/index.html  https://review.openstack.org/48266218:42
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: move config-reference.html to /configuration/  https://review.openstack.org/48258918:46
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: link to list of api guides from main page  https://review.openstack.org/48257818:46
AJaegerdhellmann: what abour redirecting https://docs.openstack.org/admin-guide/.* to the new admin/index.html page ?18:46
dhellmannAJaeger : yeah, that's a good idea, too18:47
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: redirect old admin guide to new landing page  https://review.openstack.org/48266518:49
dhellmannAJaeger : ^^18:49
dhellmannwe have a lot of stuff in flight; it may be a good idea to land it all then take one pass through and clean it up and add any missing redirects18:49
*** nicolasbock has quit IRC18:50
AJaegerdhellmann: yeah - I just went through some reviews...18:50
dhellmannyeah, I noticed, thanks18:50
dhellmannbetween my changes and your big set of mods to htaccess, I wouldn't be surprised if we have merge conflicts18:50
AJaegerthere will be for sure ;)18:51
AJaegerwe'll figure it out :)18:51
dhellmannoh, yeah, not a problem, just it might be simpler to get all of that in and then do 1 more fix patch18:51
dhellmannAJaeger : we're at 612 reviews with the topic doc-migration18:52
AJaegerwow, that's a lot18:53
AJaegerdhellmann: agreed, let's see whether asettle is around to do some mass reviewing18:53
dhellmannit would be interesting if stackalytics could filter on topic18:53
AJaeger:)18:54
dhellmannAJaeger : ++18:54
setuidAJaeger: What was the motivation to jump from mvn to tox?18:55
AJaegerdhellmann: your change https://review.openstack.org/480730 has -1 by Zuul18:55
setuidtox seems a _lot_ more fragile, and requires more deps than maven did18:55
AJaegersetuid: We jumped from Docbook XML to RST -.18:55
setuidIt's tossed in a dozen different ways already on 3 test systems I just tried to build it on, failing on all 3 in random ways18:55
dhellmannAJaeger : yeah, I need to sit down and work on that a bit more. mordred has a lib to work with that service-type data, and I should be using that instead of pulling yaml files down myself18:55
AJaegerevery python dev knows RST - nobody knows DocBook XML18:56
AJaegerdhellmann: I see18:56
mordreddhellmann: I hope to have that lib done this week - also, I added you as an initial core :)18:56
dhellmannAJaeger : maybe I'll have time for it tomorrow18:56
mordreddhellmann: welcome to the team18:56
dhellmannmordred : oh, goody! :-)18:56
AJaegerdhellmann: no worries - just wasn't sure whether you were aware of it18:56
dhellmannmordred : which repo should I be watching again?18:57
dhellmannAJaeger: yep, thanks18:57
AJaegerdhellmann: all of them ;)18:57
openstackgerritMonty Taylor proposed openstack/openstack-manuals master: Distinguish between cloud-wide and per-service apis  https://review.openstack.org/48266718:57
openstackgerritMonty Taylor proposed openstack/openstack-manuals master: Correct pluarity of "Python SDKs"  https://review.openstack.org/48266818:57
openstackgerritMonty Taylor proposed openstack/openstack-manuals master: WIP Advocate more strongly for users to use shade  https://review.openstack.org/48266918:57
mordreddhellmann: also -you may have incited me to go poke at the docs repo :)18:57
setuidOne example: https://paste.debian.net/hidden/ef71a1f6/18:58
AJaegerdhellmann: thanks!18:58
dhellmannmordred : the more the merrier!18:58
AJaegersetuid: it tries to download a remote file from stable/mitaka I guess - with mitaka-eol, you need to change those to download from mitaka-eol tag instead18:59
AJaegersetuid: grep for stable/mitaka and replace19:00
*** matjazp has joined #openstack-doc19:07
dhellmannAJaeger : will you make it to denver for the ptg?19:09
*** annegentle has joined #openstack-doc19:10
AJaegerdhellmann: nope19:10
dhellmannAJaeger : bummer19:10
*** fragatina has quit IRC19:11
*** Aqsa has joined #openstack-doc19:13
*** annegentle has quit IRC19:13
*** annegentle has joined #openstack-doc19:14
setuidAJaeger: Right, same fixes we had to do for liberty-eol tags19:28
setuidOnly 45 of them19:28
AJaegersed to the rescue ;)19:28
setuidYou want a git diff of rhese, so anyone building from these tags, can?19:28
setuidsed won't work that way19:28
setuideach file has a different verison, it's all one by one19:29
annegentlesetuid if you can write up your findings for https://docs.openstack.org/contributor-guide/docs-builds.html#building-docs-from-end-of-life-releases that would be useful!19:29
AJaegersed -e -i 's|stable/mitaka|mitaka-eol|' doc/*/*/...19:29
AJaegerhi annegentle, if you have time to merge some of dhellmann's and my changes, it would be nice - we each gave +2 to the others I think...19:30
annegentleAJaeger ok, sure19:30
annegentlesetuid the "tox + bindep" is earlier on that page for current doc builds, building from tags is specific19:31
setuidHere's the working diff for liberty-eol, for example: https://paste.debian.net/hidden/c80af360/19:31
setuidperl -pi -e 's,stable/mitaka,mitaka-eol,g' $(find . -type f -name '*.rst' -exec grep -l 'stable/mitaka' {} \;)19:32
setuid:)19:33
annegentleAJaeger all good to merge name changes, right?19:33
AJaegeryep19:34
setuidAJaeger: Is it better to work from the eol tag, vs. static file version numbers?19:36
setuideg: the above perl snippet/sed snippet, vs. what I did in the diff in the pastebin above?19:36
AJaegerI would go with the EOL tags19:37
setuidOk, fair enough, it'll make for a much smaller set of instructions/diffs19:38
openstackgerritAnne Gentle proposed openstack/openstack-manuals master: add flag to www-generator to look for links to enable  https://review.openstack.org/48231319:40
annegentleAJaeger ^^ on that, simply changed help strings, if you could re-look19:40
*** cathrichardson has quit IRC19:46
AJaegerannegentle: sure  - thanks19:46
*** cathrichardson has joined #openstack-doc19:47
annegentledhellmann AJaeger I have to say, this programmatic sorting and validation is REALLY cool19:47
annegentleI'm excited about it19:47
dhellmann:-)19:47
annegentleyeah, way nerdy :)19:47
annegentledhellmann Docs ARE Code here :)19:47
dhellmanncode + data!19:48
AJaegerannegentle: agreed - wonder why it took us so long. But we never had to make such massive changes...19:49
annegentleAJaeger 500+ patches is a bit intimidating :)19:49
annegentleAJaeger so... needed fresh eyes, I guess19:49
annegentle:)19:49
annegentleAJaeger so great to see all that /trunk/ removal :) https://review.openstack.org/#/c/482656/19:50
AJaegerannegentle: yeah, it's time...19:50
annegentleAJaeger ok to merge that? Or wait dhellmann to give another +2?19:51
AJaegerdhellmann: I'm surprised that https://review.openstack.org/#/c/482656/ gives no conflicts - do you want to +2?19:51
* dhellmann looks at the changes19:51
AJaegerannegentle: let's give him a chance ;)19:51
*** vijaykc4 has quit IRC19:51
dhellmannI just did19:51
AJaegerannegentle: so, go ahead with your +2A if you're happy - thanks19:52
annegentledhellmann thanks, merged...19:52
annegentlenow we wait builds?19:52
annegentleawait?19:52
AJaegeryes - Zuul i sreally busy, we're out of spare nodes...19:52
annegentleAJaeger eep. Okay.19:53
dhellmannyeah, and the tc meeting is starting soon so I'll be distracted19:53
dhellmannI'm going to see about cleaning up the user guide tomorrow19:53
annegentledhellmann AJaeger I think I spotted them all for today, holler if you need anything, getting on a plane later today19:53
dhellmannannegentle : safe travels, and thanks!19:53
AJaegerannegentle: safe travels!19:53
openstackgerritMerged openstack/openstack-manuals master: add validation requiring clients to have a description value  https://review.openstack.org/48227519:53
AJaegerannegentle: looks good, thanks19:54
openstackgerritMerged openstack/openstack-manuals master: shorten the shade description  https://review.openstack.org/48227619:54
openstackgerritMerged openstack/openstack-manuals master: sort libraries by service description  https://review.openstack.org/48227719:54
AJaegerdhellmann: might take an hour or more until the publishing is done19:55
dhellmannAJaeger : yep19:56
openstackgerritAndreas Jaeger proposed openstack/openstack-manuals master: add flag to www-generator to look for links to enable  https://review.openstack.org/48231319:56
AJaegerdhellmann: fixed overlong line and reapproved ^19:57
dhellmannAJaeger : ack, thanks19:57
*** emagana has quit IRC19:59
*** emagana_ has joined #openstack-doc20:00
openstackgerritMerged openstack/openstack-manuals master: Remove old redirects from .htaccess  https://review.openstack.org/48265620:01
openstackgerritAndreas Jaeger proposed openstack/openstack-manuals master: add flags for a bunch of missing guides  https://review.openstack.org/48231420:01
AJaegerdhellmann: I'll take care of your merge conflicts...20:02
openstackgerritAndreas Jaeger proposed openstack/openstack-manuals master: add flag to www-generator to look for links to enable  https://review.openstack.org/48231320:05
*** edmondsw_ is now known as edmondsw20:07
openstackgerritAndreas Jaeger proposed openstack/openstack-manuals master: add flags for a bunch of missing guides  https://review.openstack.org/48231420:08
openstackgerritAndreas Jaeger proposed openstack/openstack-manuals master: add a new landing page to list all admin guides  https://review.openstack.org/48231520:08
openstackgerritAndreas Jaeger proposed openstack/openstack-manuals master: redirect old admin guide to new landing page  https://review.openstack.org/48266520:08
openstackgerritAndreas Jaeger proposed openstack/openstack-manuals master: move admin-guide.html to admin/index.html  https://review.openstack.org/48266220:08
dhellmannAJaeger : thanks20:09
*** annegentle has quit IRC20:12
*** fragatina has joined #openstack-doc20:21
*** annegentle has joined #openstack-doc20:25
*** annegentle has quit IRC20:33
*** thorst has quit IRC20:35
openstackgerritMerged openstack/openstack-manuals master: add flag to www-generator to look for links to enable  https://review.openstack.org/48231320:37
openstackgerritMerged openstack/openstack-manuals master: add flags for a bunch of missing guides  https://review.openstack.org/48231420:38
openstackgerritMerged openstack/openstack-manuals master: add a new landing page to list all admin guides  https://review.openstack.org/48231520:38
openstackgerritMerged openstack/openstack-manuals master: move admin-guide.html to admin/index.html  https://review.openstack.org/48266220:38
openstackgerritMerged openstack/openstack-manuals master: redirect old admin guide to new landing page  https://review.openstack.org/48266520:39
*** Aqsa has quit IRC20:40
setuidwow, tox is a pig when it's building docs, drags my workstation right into the mud, 198% of the cpu20:49
setuidbouncing between > 100% and almost 200% CPU20:49
setuid8-core 4Ghz Xeon on a box with 64GB ram20:50
dhellmannsetuid : tox is just a job running. maybe you mean sphinx?20:57
dhellmannor latex?20:57
dhellmann*job runner20:58
*** Aqsa has joined #openstack-doc21:02
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: remove the user-guide  https://review.openstack.org/48270321:04
*** catintheroof has quit IRC21:04
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: move config-reference.html to /configuration/  https://review.openstack.org/48258921:06
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: move config-reference.html to /configuration/  https://review.openstack.org/48258921:06
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: move config-reference.html to /configuration/  https://review.openstack.org/48258921:10
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: link to list of api guides from main page  https://review.openstack.org/48257821:10
setuiddhellmann: Looks like python2.7, though I'm not surprised, python is a big memory hog21:10
dhellmannthat's probably sphinx, then21:10
* setuid goes back to the Great Pyramid and tries to petition for more memory 21:11
*** rbowen has quit IRC21:13
dhellmannmordred : https://review.openstack.org/48270321:13
dhellmannthat's the patch that I had been working on to remove the user guide.21:13
dhellmannasettle, AJaeger : we probably want to do a little more due diligence to make sure I'm not deleting user-guide content that is useful ^^21:14
*** efried has joined #openstack-doc21:19
efrieddhellmann I noticed ceilometer-powervm got flagged in the "list of stuff that we expect to be doing doc migration, but hasn't started"21:20
dhellmannefried : yep, gordc already mentioned that it shouldn't be on that list21:20
efrieddhellmann What's weird to me is that I would have expected nova-powervm and networking-powervm to be in the same boat as ceilometer-powervm - either all three flagged or all three ignored.21:20
efrieddhellmann What were the criteria used for being flagged?21:21
dhellmannit was stuff like has a doc/source directory21:21
efriedokay; all three of those guys do...21:21
dhellmannbut I ended up with a bunch of repos that aren't official, or aren't active21:21
dhellmannso yeah, please do move the content, but we're mainly focused on tracking the official active repos21:21
*** dustins has quit IRC21:22
efrieddhellmann Okay, so I had been skimming-but-mostly-disregarding the notes flying through on the topic; can you please point me to the overview of what action needs to be taken?21:22
efriedSorry about that.21:23
*** pcaruana has quit IRC21:23
dhellmannefried : sure, there's a spec21:23
dhellmannefried : http://specs.openstack.org/openstack/docs-specs/specs/pike/os-manuals-migration.html21:23
efrieddhellmann Cause I thought the point was to make sure docs were in the doc/source dir of the project they belong to... which those are.21:23
efriedokay, thank you.21:23
dhellmannlet me know if you have any questions21:23
dhellmannfor projects where we're going to link to them from the docs landing pages, we need the content in specific directories21:24
efriedGotcha.21:24
dhellmanndo you publish docs to docs.openstack.org?21:24
efriedUhhh21:24
efriedI know we publish them *somewhere*.21:24
efriedLemme find out where...21:24
dhellmannthey may go to readthedocs.org21:24
dhellmannefried : if they're not on docs.openstack.org you don't need to do anything21:25
efrieddhellmann Looks like it is readthedocs.21:28
efriedWohoo, no action necessary!21:28
dhellmannthe best kind of action!21:28
*** thorst has joined #openstack-doc21:35
*** efried has left #openstack-doc21:36
*** thorst has quit IRC21:42
*** Aqsa has quit IRC21:59
*** edmondsw has quit IRC22:26
*** suyog has joined #openstack-doc22:32
*** charcol has quit IRC22:58
*** tosky has quit IRC23:13
*** matjazp has quit IRC23:34
*** d0ugal has joined #openstack-doc23:36
*** thorst has joined #openstack-doc23:47

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