Tuesday, 2017-06-27

« Monday, 2017-06-26 Index Wednesday, 2017-06-28 »
*** thorst has joined #openstack-doc00:01
*** masaki has joined #openstack-doc00:02
*** thorst has quit IRC00:03
*** salv-orlando has quit IRC00:07
*** salv-orlando has joined #openstack-doc00:08
*** yangyape_ has quit IRC00:22
*** yangyapeng has joined #openstack-doc00:23
*** yangyapeng has quit IRC00:27
*** salv-orl_ has joined #openstack-doc00:37
*** salv-orlando has quit IRC00:40
*** annegentle has quit IRC00:41
*** suyog has quit IRC00:42
*** suyog has joined #openstack-doc00:44
*** annegentle has joined #openstack-doc00:45
*** lucasxu has joined #openstack-doc00:57
*** lucasxu has quit IRC00:57
*** thorst has joined #openstack-doc01:04
*** phuongnh has joined #openstack-doc01:06
*** thorst has quit IRC01:10
*** cathrichardson has joined #openstack-doc01:26
*** cathrich_ has quit IRC01:26
*** dmacpher has quit IRC01:52
*** annegentle has quit IRC02:26
*** emagana has quit IRC02:34
*** emagana has joined #openstack-doc02:35
*** dmacpher has joined #openstack-doc02:36
*** emagana has quit IRC02:40
*** dmacpher has quit IRC03:15
*** yamamoto has joined #openstack-doc03:29
*** dmacpher has joined #openstack-doc03:33
*** thorst has joined #openstack-doc03:35
*** emagana has joined #openstack-doc03:35
*** emagana has quit IRC03:41
*** thorst has quit IRC03:41
*** sridhar_ram has joined #openstack-doc04:01
*** Dinesh_Bhor has joined #openstack-doc04:02
*** amotoki_away is now known as amotoki04:10
*** masaki has quit IRC04:31
*** masaki has joined #openstack-doc04:31
*** emagana has joined #openstack-doc04:36
*** thorst has joined #openstack-doc04:38
*** emagana has quit IRC04:41
*** thorst has quit IRC04:43
openstackgerritAndreas Jaeger proposed openstack/openstack-manuals master: Simplify conf.py for openstackdocstheme 1.11.0  https://review.openstack.org/47764604:53
openstackgerritMerged openstack/openstackdocstheme master: Updates "Contents" to "Project home page" to better match existing  https://review.openstack.org/47763505:03
openstackgerritAndreas Jaeger proposed openstack/openstack-manuals master: Simplify conf.py for openstackdocstheme 1.11.0  https://review.openstack.org/47764605:05
*** EmilienM has quit IRC05:13
openstackgerritMerged openstack/openstack-manuals master: [contributor] Point to example review for new package release  https://review.openstack.org/47653605:15
*** EmilienM has joined #openstack-doc05:20
openstackgerritAndreas Jaeger proposed openstack/security-doc master: Update for new openstackdocstheme  https://review.openstack.org/47775405:25
openstackgerritAndreas Jaeger proposed openstack/api-site master: Update openstackdocstheme  https://review.openstack.org/47775605:30
*** emagana has joined #openstack-doc05:37
openstackgerritAndreas Jaeger proposed openstack/api-site master: Update openstackdocstheme  https://review.openstack.org/47775605:38
*** fhardy_ has quit IRC05:39
*** katyafervent_awa has quit IRC05:39
openstackgerritAndreas Jaeger proposed openstack/security-doc master: Update for new openstackdocstheme  https://review.openstack.org/47775405:39
*** fhardy_ has joined #openstack-doc05:40
*** emagana has quit IRC05:41
*** yangyapeng has joined #openstack-doc05:41
*** katyafervent_awa has joined #openstack-doc05:42
*** rcernin has joined #openstack-doc05:55
openstackgerritAndreas Jaeger proposed openstack/security-doc master: Update for new openstackdocstheme  https://review.openstack.org/47775406:03
*** yangyapeng has quit IRC06:06
*** yangyapeng has joined #openstack-doc06:07
*** sridhar_ram has quit IRC06:11
*** yangyapeng has quit IRC06:12
*** rcernin has quit IRC06:26
*** rcernin has joined #openstack-doc06:32
*** suyog has quit IRC06:33
*** salv-orlando has joined #openstack-doc06:37
*** jarvis has joined #openstack-doc06:38
jarvishi facing an issue with git review06:38
*** jarvis is now known as Guest3211806:38
*** Guest32118 has quit IRC06:38
*** _jarvis has joined #openstack-doc06:38
_jarvishi can anyone help me06:39
_jarviswith git review failure gives me an error06:39
*** salv-orl_ has quit IRC06:40
_jarvisfatal : ICLA contribution agreement requires current contact information. Please review your contact information06:41
*** andreas_s has joined #openstack-doc06:41
*** thorst has joined #openstack-doc06:47
*** thorst has quit IRC06:52
chason_jarvis: You need to update your contact information at https://review.openstack.org/#/settings/contact06:53
*** tesseract has joined #openstack-doc06:55
_jarvistired07:01
_jarvisbut getting an error07:01
_jarviscannot store network information07:02
*** dmacpher has quit IRC07:06
*** jeblair has quit IRC07:08
*** charcol has quit IRC07:09
*** jeblair has joined #openstack-doc07:09
*** salv-orlando has quit IRC07:10
*** salv-orlando has joined #openstack-doc07:10
*** salv-orlando has quit IRC07:14
*** salv-orlando has joined #openstack-doc07:20
*** jpena|off is now known as jpena07:21
AJaeger_jarvis: http://docs.openstack.org/infra/manual/developers.html explains how to do it - follow it step by step07:27
AJaeger_jarvis: This needs your gerrit preferred e-mail address to match a primary e-mail address for a foundation individual member account.07:28
AJaeger_jarvis: see https://ask.openstack.org/question/56720 for additional troubleshooting tips.07:28
*** pcaruana has joined #openstack-doc07:32
openstackgerritArundhati Surpur proposed openstack/openstack-manuals master: Firewall-as-a-Service (FWaaS) v2 scenario in Networking Guide  https://review.openstack.org/47779707:35
*** emagana has joined #openstack-doc07:38
*** emagana has quit IRC07:42
openstackgerritPRAVIN proposed openstack/openstack-manuals master: Add key-manager section for glance-api config  https://review.openstack.org/47781108:12
*** s-shiono has quit IRC08:16
*** vijaykc4 has joined #openstack-doc08:17
_jarvis@AJaeger when can I commit it08:22
_jarvismeans when will the migration be complete08:22
*** salv-orlando has quit IRC08:23
openstackgerritIldiko Vancsa proposed openstack/training-guides master: [upstream] Add trainers' guide to the web page  https://review.openstack.org/47781708:27
AJaeger_jarvis: it really depends on the speed of the other teams08:33
AJaeger_jarvis: and then you need to commit in the project repos like neutron08:34
openstackgerritIldiko Vancsa proposed openstack/training-guides master: [upstream] Add trainers' guide to the web page  https://review.openstack.org/47781708:34
_jarvisAJaeger : thanks will commit after migration08:36
*** thorst has joined #openstack-doc08:49
*** thorst has quit IRC08:53
*** masaki has quit IRC08:53
openstackgerritIldiko Vancsa proposed openstack/training-guides master: [upstream] Add trainers' guide to the web page  https://review.openstack.org/47781708:53
*** d0ugal has quit IRC08:58
*** d0ugal_ has joined #openstack-doc08:59
*** d0ugal_ has quit IRC08:59
*** d0ugal has joined #openstack-doc08:59
*** d0ugal has quit IRC08:59
*** d0ugal has joined #openstack-doc08:59
*** _jarvis has quit IRC09:06
asettleMorning o/09:06
AJaegermorning, asettle09:11
asettleAJaeger: how are you? :)09:11
AJaegerasettle: I updated all docs repos for the new theme - reviews are welcome https://review.openstack.org/#/q/status:open+topic:themeupdate09:12
asettleAJaeger: on it :)09:12
AJaegerasettle: I'm fine. And you?09:12
asettleAJaeger: are you happy for +2a?09:12
asettleSimilar, similar09:12
asettleBusy09:12
AJaegerYeah, busy ;(09:12
AJaegerI'm happy for +2a...09:13
AJaegersince that's the new version of the theme that *all* projects will use, I wanted to update early to guinea-pig09:13
asettleAJaeger: okay, cool. I'll have a review in a momento :)09:13
asettleHave you had a look at Anne's? https://review.openstack.org/#/c/468021/09:14
AJaegerasettle: I approved her other change, the above will take a bit longer - so later today09:14
AJaegerAh, missed that one - was thinking about another one09:14
AJaegerasettle: go ahead and merge it in ;)09:15
*** vijaykc4 has quit IRC09:15
* AJaeger merged quickly09:16
chasonAJaeger: Do we need to update other projects repos for the new theme?09:16
AJaegerchason: you need to update for going from oslosphinx to openstackdocstheme09:17
chasonOK09:18
asettleAJaeger: yes thank you :) sorry, went to grab a phone call09:18
AJaegerchason: it would be nice to update if they use old optios - like https://review.openstack.org/#/q/status:open+topic:themeupdate does09:18
AJaegerbbl09:19
openstackgerritMerged openstack/openstackdocstheme master: Working on integrating options from oslosphinx theme  https://review.openstack.org/46802109:20
asettleAJaeger: merging09:20
*** yamamoto has quit IRC09:23
openstackgerritMerged openstack/api-site master: Update openstackdocstheme  https://review.openstack.org/47775609:23
openstackgerritMerged openstack/security-doc master: Update for new openstackdocstheme  https://review.openstack.org/47775409:24
*** jpena is now known as jpena|brb09:26
*** vijaykc4 has joined #openstack-doc09:28
*** tosky has joined #openstack-doc09:28
*** yamamoto has joined #openstack-doc09:29
*** rromans has joined #openstack-doc09:29
*** tonyb_ has joined #openstack-doc09:30
openstackgerritMerged openstack/openstack-manuals master: Update requirements  https://review.openstack.org/47763609:31
openstackgerritMerged openstack/openstack-manuals master: Simplify conf.py for openstackdocstheme 1.11.0  https://review.openstack.org/47764609:31
*** OGtrilliams has joined #openstack-doc09:34
*** d0ugal has quit IRC09:34
*** pblaho has quit IRC09:34
*** AJaeger has quit IRC09:34
*** PagliaccisCloud has quit IRC09:34
*** tonyb has quit IRC09:35
*** rromans_ has quit IRC09:35
*** OGtrilliams is now known as PagliaccisCloud09:35
*** tosky_ has joined #openstack-doc09:39
*** emagana has joined #openstack-doc09:39
*** tosky has quit IRC09:39
*** vijaykc4 has quit IRC09:39
*** d0ugal has joined #openstack-doc09:40
*** AJaeger has joined #openstack-doc09:41
asettleugh ildikov I'm so sorry - I got dragged into a meeting09:41
*** pblaho has joined #openstack-doc09:41
ildikovasettle: don't worry, you can ping me later if you want to chat about the second topic09:41
ildikovasettle: or we can try at the time of the training-guides meeting this afternoon :)09:42
*** emagana has quit IRC09:43
*** chlong has joined #openstack-doc09:47
*** jpena|brb is now known as jpena09:57
*** tosky_ is now known as tosky10:01
*** kyguo has joined #openstack-doc10:14
*** oanson has quit IRC10:15
*** oanson has joined #openstack-doc10:16
*** vijaykc4 has joined #openstack-doc10:16
asettleildikov: I reviewed your doc just now10:17
asettleAnd the other conversation was Mike's email, yes? :)10:17
*** kyguo has quit IRC10:18
ildikovasettle: thanks :)10:24
ildikovasettle: yep, it was :)10:24
*** thorst has joined #openstack-doc10:26
asettleildikov: sorry, could you recap for me? :)10:27
*** vijaykc4 has quit IRC10:27
*** phuongnh has quit IRC10:28
asettleAJaeger: do you happen to remember if we came to a conclusion about the glossary?10:28
*** thorst has quit IRC10:29
asettlechason has kicked this off for the neutron team: https://review.openstack.org/#/c/477828/210:29
asettleBut I don't believe it's the best option.10:29
asettledhellmann: for when you're in ^10:29
*** vijaykc4 has joined #openstack-doc10:30
ildikovasettle: I just hope to use the Contributor Portal for the training so we don't need to maintain that much of the lecture material but focus more on the exercises10:32
*** kyguo1 has joined #openstack-doc10:32
chasonasettle: https://etherpad.openstack.org/p/doc-migration-tracking see line 63910:32
asettleildikov: that sounds like a good idea.10:32
*** kyguo1 has quit IRC10:33
asettlechason: and then see line 640 and line 641. I agree with whoever wrote that in green, I don't think it's a good idea with the maintenance10:33
asettleI'd like to discuss it further10:33
chasonasettle: OK, I think we should find a solution as soon as possible. If we don't import the glossary, the Jenkins will failed. see http://logs.openstack.org/98/477498/4/check/gate-neutron-docs-ubuntu-xenial/5fd8bf0/console.html#_2017-06-27_06_29_33_03698810:39
asettlechason: Yes, true. I do wonder the importance of the glossary having to be linked. I appreciate that's why we use it in the first place.10:40
chasonOption 1: remove all the ":term:``"10:40
asettleTo be honest, I'm very tempted to remove the glossary in full.10:40
chasonOption 2: import the glossary.10:40
*** yangyapeng has joined #openstack-doc10:41
*** yangyapeng has quit IRC10:46
*** amotoki is now known as amotoki_away10:46
AJaegerasettle: no idea about glossary ;(10:50
AJaegerpushing the glossary to each and every repo will lead to many inconsistent versions.10:51
*** amotoki_away is now known as amotoki10:51
AJaegerI suggest to publish the glossary on its own10:52
asettleAJaeger: that's my concern, I am quite against pushing to each repo.10:54
asettleI actually think we remove all the :term: as chason mention in the first option, and keep the glossary as a separate entity in the docs repo10:54
AJaegerasettle: yes, I agree with that.10:55
asettleAJaeger: okay, I think Anne does too. I think between the three of us we can take on dhellmann :P10:56
AJaegeralternative would be to update our building to get the glossary from remote for builds - but not sure how to do this best10:56
AJaeger;)10:56
asettleAJaeger: I honestly think that's more trouble than it's worth10:56
asettleWe're already going through a *lot* of changes to make this happen10:56
AJaegerasettle: indeed.10:57
*** amotoki is now known as amotoki_away11:01
*** chlong_ has joined #openstack-doc11:04
*** chlong has quit IRC11:04
*** vijaykc4 has quit IRC11:12
*** johnthetubaguy has quit IRC11:16
*** vijaykc4 has joined #openstack-doc11:18
*** johnthetubaguy has joined #openstack-doc11:18
*** vijaykc4 has quit IRC11:24
*** vijaykc4 has joined #openstack-doc11:24
*** suyog has joined #openstack-doc11:29
*** vijaykc4 has quit IRC11:30
*** pkovar has joined #openstack-doc11:33
*** emagana has joined #openstack-doc11:40
*** emagana has quit IRC11:45
*** yangyapeng has joined #openstack-doc11:47
*** vijaykc4 has joined #openstack-doc11:54
*** jpena is now known as jpena|lunch11:55
*** ericyoung has joined #openstack-doc11:56
*** suyog has quit IRC11:57
*** yangyapeng has quit IRC12:02
*** dustins has joined #openstack-doc12:07
*** ericyoung has quit IRC12:07
*** amotoki_away is now known as amotoki12:07
*** egallen has joined #openstack-doc12:10
*** yangyapeng has joined #openstack-doc12:13
*** yangyapeng has quit IRC12:16
*** yangyapeng has joined #openstack-doc12:17
openstackgerritOpenStack Proposal Bot proposed openstack/openstack-doc-tools master: Updated from global requirements  https://review.openstack.org/47803812:19
openstackgerritOpenStack Proposal Bot proposed openstack/openstackdocstheme master: Updated from global requirements  https://review.openstack.org/47803912:19
*** edmondsw has joined #openstack-doc12:19
*** egallen_ has joined #openstack-doc12:20
*** yangyapeng has quit IRC12:22
*** egallen has quit IRC12:23
*** egallen has joined #openstack-doc12:23
*** egallen_ has quit IRC12:25
*** pnavarro has joined #openstack-doc12:37
*** egallen has quit IRC12:44
dhellmannasettle, AJaeger : removing the term markup works for me.12:50
asettledhellmann: okay, cool.12:50
dhellmannas does importing only the relevant terms12:50
dhellmannwhatever is easier12:50
asettledhellmann: easier will be removing :term: in the long term12:51
asettleThe maintenance of the glossary will seriously get out of hand12:51
dhellmannok. I'll update the migration patches I've already proposed12:51
asettleThank you dhellmann :)12:51
asettlei've updated the doc-migration-tracking12:52
dhellmanndo we need to update the steps in the spec? maybe we should remove that section and refer to the tracking doc for directions, if we're going to modify them as we figure out what we're doing :-)12:53
*** pblaho has quit IRC12:54
asettledhellmann: hmmm good point12:54
asettleI would say we should update the spec12:54
asettleI don't want to keep pointing to an etherpad12:54
asettleWasn't that someone's nit in the beginning?12:54
*** yangyapeng has joined #openstack-doc12:56
*** yangyapeng has quit IRC12:56
dhellmannI don't remember. maybe? but sure, either way.12:56
*** egallen has joined #openstack-doc12:56
asettleI can update the spec12:57
dhellmannok12:57
* dhellmann disappears for an errand12:57
*** jpena|lunch is now known as jpena12:58
asettledhellmann: uhhh I don't think we included the glossary in the spec, tbh12:58
asettleI think we should be good to just keep the update in the etherpad in that case13:00
openstackgerritMerged openstack/openstack-doc-tools master: Updated from global requirements  https://review.openstack.org/47803813:00
openstackgerritMerged openstack/openstackdocstheme master: Updated from global requirements  https://review.openstack.org/47803913:00
AJaegerasettle: then include in the spec: Create a separate glossary, project repos will not use :term:13:03
pkovarwhat's the plan with the glossary then?13:03
pkovar+1 for having one glossary doc13:03
*** pblaho has joined #openstack-doc13:04
*** lucasxu has joined #openstack-doc13:05
*** vijaykc4 has quit IRC13:07
asettlepkovar: remove :term: from all migrated docs13:07
asettleAJaeger: will update with that then13:07
asettleAJaeger: put it in the work itesm?13:08
asettleitems*13:08
openstackgerritAndreas Jaeger proposed openstack/openstack-manuals master: Build separate glossary  https://review.openstack.org/47814213:11
AJaegerasettle: yes, put it into works items and explain that :term: needs to be removed when importing13:11
AJaegerpkovar, chason, dhellmann, asettle : Here's a first patch to build and publish the glossary ^13:11
asettleAJaeger: thank you!13:12
asettleREviewing13:12
AJaegerlet me disable translations for now...13:12
asettleIncoming spec update13:13
openstackgerritAlexandra Settle proposed openstack/docs-specs master: Add glossary decision to doc-migration spec  https://review.openstack.org/47814513:13
AJaegeroh, no need to disable translations...13:13
AJaegerreviewing, asettle13:13
openstackgerritAlexandra Settle proposed openstack/docs-specs master: Add glossary decision to doc-migration spec  https://review.openstack.org/47814513:18
asettleAJaeger: upadted13:18
AJaegerasettle: you're fast ;)13:18
asettleAJaeger: you bet!13:18
AJaegerasettle: LGTM13:19
asettleThank youuuuu13:19
openstackgerritIldiko Vancsa proposed openstack/training-guides master: [upstream] Add trainers' guide to the web page  https://review.openstack.org/47781713:20
*** cathrich_ has joined #openstack-doc13:30
chasonAJaeger: Thanks! :)13:31
*** yangyapeng has joined #openstack-doc13:33
*** cathrichardson has quit IRC13:33
*** vijaykc4 has joined #openstack-doc13:34
*** yangyapeng has quit IRC13:38
*** emagana has joined #openstack-doc13:40
*** thorst has joined #openstack-doc13:40
*** thorst has quit IRC13:44
*** emagana has quit IRC13:45
*** ericyoung has joined #openstack-doc13:45
*** yangyapeng has joined #openstack-doc13:51
*** thorst has joined #openstack-doc13:54
*** thorst has quit IRC13:56
*** yangyapeng has quit IRC13:59
*** egallen has quit IRC14:00
*** mikal has quit IRC14:00
*** yangyapeng has joined #openstack-doc14:02
*** mikal has joined #openstack-doc14:02
*** yangyapeng has quit IRC14:08
*** yangyapeng has joined #openstack-doc14:09
EmilienMdhellmann: when changing the doc theme for releasenotes, do we need to backport the patches into stable branches?14:10
asettleEmilienM: I don't believe we've been doing so, no14:13
asettleBut that's a good question14:13
EmilienMasettle: thx for the answer :)14:13
EmilienMI won't do it for now14:14
*** ericyoung has quit IRC14:14
asettleEmilienM: safe bet. I've never done it before.14:14
asettledhellmann: https://review.openstack.org/#/c/478145/14:14
asettlepkovar: so, I replied to your comment on https://review.openstack.org/#/c/477518/14:14
asettleIf you think having it in the folder is a bad idea, I"m happy to abandon :)14:14
*** yangyapeng has quit IRC14:18
pkovar/me looking14:19
pkovarasettle: i'd like to have both pre- and after- deployment tasks inside one folder, install-guide, preferably14:20
pkovarwe could go with doc/install-guide/verify... too14:21
pkovarthough its really just launching instance, nothing more or less14:21
pkovarnote that each project install guide also has a "verify" section14:22
asettlepkovar: yeah I did notice that while doing my migration for cinder today14:22
asettleHmmm14:22
pkovarso, i'd just keep it where it is now14:22
pkovarincluding the section name14:22
*** yangyapeng has joined #openstack-doc14:23
asettlepkovar: I"ll abandon :) we can revisit14:23
pkovarsure thing. and thank you, asettle14:24
pkovarbtw, what's the plan for https://docs.openstack.org/project-deploy-guide/ocata/14:24
pkovar?14:24
asettlepkovar: none. The deployment guides are staying where they are - they are already in project repos and build14:24
asettleKeeping a the deploy-guide-gate job14:24
pkovarasettle: so for new projects, they are supposed to follow the established process, no change there?14:25
asettlepkovar: 'new projects'? What does that identify?14:25
dhellmannEmilienM, asettle : release notes always build from master branches14:25
EmilienMgood to know14:26
EmilienMthanks14:26
asettleIndeed14:26
dhellmannasettle, AJaeger : do we really want the glossary to be its own doc?14:26
pkovarasettle: i mean project who want to add their deployment docs to the docs site14:26
pkovarprojects, rather14:26
asettlepkovar: ah yes, follow that established process which is documented in our contributor guide14:26
asettledhellmann: yes. I don't want to lose the glossary14:26
asettleAnd the easiest/best option imho was to remove the :term: links14:26
asettleBut keeping that glossary is beneficial.14:26
asettleI believe, anyway14:26
pkovardhellmann: fwiw, i do :)14:27
dhellmannsure, but why publish it on its own instead of part of an existing doc?14:27
asettledhellmann: what existing doc would you recommend?14:27
pkovardhellmann: it applies to the whole project, not just a specific topic?14:27
asettleThe glossary is a fairly significant beast on its own14:27
dhellmannyour whole publishing pipeline would be way simpler if you just combined everything that's going to be left after this migration into a single sphinx build14:27
asettledhellmann: I'm not sure I'm seeing the problem?14:28
dhellmannmaybe it's not a big deal. it's just that as I've been trying to add templates to the www stuff I can't help but keep thinking "this is so complicated"14:29
dhellmannand I don't really understand the goal that caused it to be like it is14:29
asettleThe www being complicated?14:30
asettleI think I'm missing a link there. Is the templating complicated, or is the stuff we have already existing making the implementation complicated?14:31
dhellmannit's the whole thing14:32
dhellmannsorry, stepped away to change the washer14:32
*** d0ugal has quit IRC14:32
asettleNo problem14:32
chasonasettle, AJaeger: I guess just remove the :term: is not enough. This will cause terms to lose link with the glossary. It will be difficult to add the new glossary entry to terms.14:32
dhellmannwe're in the process of making docs simpler in all of the other repos by moving everything into one sphinx build14:32
*** d0ugal has joined #openstack-doc14:32
*** d0ugal has quit IRC14:32
*** d0ugal has joined #openstack-doc14:32
dhellmannand yet in the manuals repo we're adding a *new* sphinx tree just to hold a single-page glossary?14:33
dhellmannsomehow that seems counter to simplifying the process of managing the docs14:33
dhellmannif we moved all of the remaining content together into one sphinx tree, we could avoid the custom build scripts that are needed now to merge the build output together14:34
chasonasettle: Please see my comment inline https://review.openstack.org/#/c/478145/14:34
*** yangyapeng has quit IRC14:37
*** yangyapeng has joined #openstack-doc14:37
*** yangyapeng has quit IRC14:41
asettledhellmann: so, i'm not at all against having one sphinx build. I mean, we don't have to go ahead with https://review.openstack.org/#/c/478142/ at all. But I guess I'm not quite visualising what you're saying right now, and I'm not too sure how what you are recommending will look?14:42
*** yangyapeng has joined #openstack-doc14:42
asettlechason: yes, absolutely. We want to lose the links to the glossary14:43
dhellmannasettle: let me put together a patch14:43
asettledhellmann: that'd be great, thanks14:43
asettleIf it's not too much trouble14:43
openstackgerritAlexandra Settle proposed openstack/docs-specs master: Add glossary decision to doc-migration spec  https://review.openstack.org/47814514:44
asettleAlso, updated ^14:44
*** annegentle has joined #openstack-doc14:44
chasonasettle: Yeah, I know. Aren't we going to add links to the glossary in the future?14:47
asettlechason: no. The premise would be that the glossary is a separate entity. If anything, at all, the project repos can choose to link to the glossary if they so desire14:47
*** annegentle has quit IRC14:49
chasonasettle: Alright, BTW, it might better to add " If anything, at all, the project repos can choose to link to the glossary if they so desire" to the doc migration spec. :)14:52
asettlechason: sure :)14:54
openstackgerritAlexandra Settle proposed openstack/docs-specs master: Add glossary decision to doc-migration spec  https://review.openstack.org/47814514:55
asettleUpdated14:55
chasonasettle: I just want to remind that the glossary is the explanation of terms. If we ignore the terms of glossary entry, the glossary might make no sense and nobody would specially read glossary doc.15:00
*** egallen has joined #openstack-doc15:00
chason*the glossary entry of  terms15:01
chasonSorry. :)15:01
pkovarchason: i'd argue that it will still show up in search results so users can consume it that way15:02
*** yangyapeng has quit IRC15:02
asettleI agree with pkovar here. THat is how I have previously used a glossary15:02
*** yangyapeng has joined #openstack-doc15:02
pkovaralso, it serves the purpose of a single point of reference doc for internal needs15:03
pkovarensuring we use terms consistently across the doc suite15:03
asettlepkovar: perfect, 10 points to you for explaining what's on my brain15:03
pkovarheh15:04
asettleI loved what we did with the glossary, I think it was a very cool way to use it, but we cannot continue.15:04
*** rcernin has quit IRC15:04
pkovaryeah15:04
*** yangyapeng has quit IRC15:07
*** yangyapeng has joined #openstack-doc15:07
*** vijaykc4 has quit IRC15:08
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: move library data from openstack-projects.html to projects.yaml  https://review.openstack.org/47625215:09
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: delete project-specific steps from installation guide  https://review.openstack.org/47539515:09
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: update contributor guide based on changes after migration project  https://review.openstack.org/47762415:09
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: stop generating content if a template can't be parsed or rendered  https://review.openstack.org/47625015:09
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: set up template rendering to support multiple series  https://review.openstack.org/47725015:09
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: add jsonschema validation to the start of the template rendering  https://review.openstack.org/47625115:09
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: show install guides in order by service description, like we do elsewhere  https://review.openstack.org/47724915:09
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: templatize the language-bindings page  https://review.openstack.org/47624815:09
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: group projects from the same team together in template data file  https://review.openstack.org/47724815:09
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: templatize more of openstack-projects list  https://review.openstack.org/47624915:09
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: remove project-specific content from admin guide  https://review.openstack.org/47543515:09
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: add a link to the shared install guide  https://review.openstack.org/47765215:09
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: move getting started content into the install guide  https://review.openstack.org/47543415:09
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: add a global project list file for main site templates  https://review.openstack.org/47624715:09
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: fix pdf build  https://review.openstack.org/47540815:09
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: fix schema to guard against misnamed properties  https://review.openstack.org/47695715:09
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: templatize the list of api reference guides  https://review.openstack.org/47695815:09
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: replace install-guide landing page contents with list of projects  https://review.openstack.org/47551815:09
dhellmannasettle : https://review.openstack.org/478190 is heading towards what I'm talking about15:09
asettleyou just proposed a lot woah15:10
dhellmannyeah, I had to rebase the rest of the series because of changes to some of the config files15:10
asettleJeez15:10
dhellmannmaybe AJaeger's theme update? I didn't check15:10
asettleHahaokay15:10
asettleohhhh15:10
asettleYes probably15:10
dhellmannthis is why having the repo frozen is important :-/15:10
asettleI agree completely. But theme gotta theme15:11
*** donghao has joined #openstack-doc15:11
*** yangyapeng has quit IRC15:12
*** thorst has joined #openstack-doc15:13
*** lucasxu has quit IRC15:14
AJaegerdhellmann: oops, sorry. That was config, not content for me ;( But you're right...15:14
*** vijaykc4 has joined #openstack-doc15:15
dhellmannasettle : I changed the tox.ini so that patch will build locally but you won't see the difference in the gate job because I didn't take the time to figure out how to make that work right15:15
*** yangyapeng has joined #openstack-doc15:15
dhellmannAJaeger : no problem, it was relatively easy to resolve the conflicts15:15
asettledhellmann: OH. I'll pull down now15:15
dhellmannasettle : so you'd want to run "tox -e docs" and then look in docs/build/html to see the results15:16
asettledhellmann: sure :)15:16
*** lucasxu has joined #openstack-doc15:16
asettleuno momento15:16
AJaegerdhellmann: we have been to far into continuing to do as we did to see how to improve, thanks for your fresh eyes!15:16
AJaegerdhellmann: if we merge all docs into one book, we have to rethink translations since we currently do not translate everything15:16
dhellmannAJaeger : I wish I had had the time to be involved in the early discussions15:16
dhellmannAJaeger : ok, that's good to know15:17
*** annegentle has joined #openstack-doc15:17
dhellmanndo we only translate the install guide?15:17
asettledhellmann: nope, everything15:17
dhellmannwell, AJaeger just said differently?15:17
asettleWell, sorry hahahaha15:17
asettleI didn't mean it literally15:17
asettleSometimes, being in person helps15:18
dhellmannheh, ok15:18
asettleTuesday afternoon-itis15:18
asettleAnywayyyyy15:18
asettleInstall, API15:18
dhellmannI'm guessing that the docs that aren't translated are managed by other teams?15:18
dhellmannright15:18
AJaegerdhellmann:, see doc-tools-check-languages.conf on what is translated currently15:18
asettleSome languages translate training materials too15:19
dhellmannoh, duh, I had to edit that file15:19
*** salv-orlando has joined #openstack-doc15:19
*** yangyapeng has quit IRC15:19
dhellmannand I suppose there's no way to tell what part of the doc a given bit of text came from, is there?15:19
dhellmannok, maybe translations is the reason things are they are, and that's ok15:20
AJaegerdhellmann: depending on what content is left in the end, we might just merge it together...15:20
dhellmannsure. so maybe this is a conversation to have later on, when we've finished the purge15:20
dhellmannthat may be motivation for moving the security guide and ha guide into their own repos, too15:21
dhellmannto simplify the translation story15:21
AJaegerdhellmann: the security guide is in its own tree already15:21
dhellmannso it is15:21
AJaegerdhellmann: and it's translated ;915:22
asettleHA might be worth moving back15:22
dhellmannnah, let's not move things we don't have to15:22
dhellmannwe said we were going to remove the arch guides, right?15:22
asettledhellmann: well, 'decommission'15:22
dhellmannoh, no, just mark it as stable as of pike15:22
dhellmannright15:22
asettleYep :)15:22
asettleI've got to check in with Ben on how he's going with that15:22
AJaegerso, the contributor-guide is currently *not* translated. We could merge the others - or ask for not translating it as well...15:23
asettleAlso need to check in with aspiers and csatari on how the HA guide world is too15:23
dhellmannAJaeger : the contributor guide content could move to its own repo, too15:23
dhellmannor the specs repo?15:23
asettleAJaeger: I don't think we need it translated, do we? It's for the English manuals15:23
dhellmannif we said "anything in openstack-manuals will be translated" then does that help us decide what stays there?15:23
asettlespecs repo might make sense, actually. I'd rather avoid adding new repos if possible15:24
dhellmannright, that's what I was thinking15:24
asettledhellmann: doesn't leave much, but yep, that would make it very clear cut15:24
dhellmannok, that's probably something for us to think about after we've made more progress on the migration15:24
asettledhellmann: add to the list!15:24
AJaegerdhellmann: that's one option for doing it.15:25
AJaegerdhellmann, asettle, I'll -2 my glossary build for now, we can look at that later...15:27
dhellmannasettle , AJaeger : item 15 on the future problems etherpad15:27
*** lucasxu has quit IRC15:28
*** thorst has quit IRC15:29
AJaegerdhellmann: do you have an URL for me? I don't have that one handy ;(15:29
asettleAJaeger: okay :)15:29
dhellmannhttps://etherpad.openstack.org/p/doc-future-problems15:29
asettlehow do we have *15* problems already jeez15:29
dhellmannasettle : 2 are solved15:30
asettleI like that15:30
dhellmanna bunch of that is my notes about trying to simplify the build, too15:30
asettleI did notice that15:30
AJaegerdhellmann: thanks for clarifying live ;)15:32
dhellmannthat's a little more organized now15:35
*** pnavarro has quit IRC15:35
asettleokay, after some techno issues, I can finally test your patch dhellmann15:37
* dhellmann imagines asettle testing to dance music15:38
* asettle turns off tunes15:38
asettleUhh15:38
asettleNo15:38
asettleHow do people test without tunes?!15:38
asettleYou caught me jamming to: https://www.youtube.com/watch?v=fPt-hkcvoJ015:39
AJaegerasettle: any meaning behind the song title and your work ? ;)15:39
*** ericyoung has joined #openstack-doc15:39
asettleAJaeger: hahahahhaahhahahahahaa15:39
asettleSigh15:39
asettleNo :(15:39
asettle*starts building*15:40
asettleI need a wand to wave when I start doing that15:40
*** emagana has joined #openstack-doc15:41
*** yangyapeng has joined #openstack-doc15:43
asettledhellmann: okay, I see what you're seeing15:43
asettleObviously I'd like it to be a lot prettier as it's our home page, but yeah, nice and simples15:44
*** yangyapeng has quit IRC15:44
*** yangyapeng has joined #openstack-doc15:44
dhellmannasettle : we should be able to pretty it up by using a templated page to replace the index page15:45
asettleYou sure love your templates15:45
asettleBut that works for me15:45
dhellmannhand editing html is so 199515:45
* asettle hides15:45
asettleOh okay15:45
asettlesure15:45
asettle199515:45
asettle*shifty eyes*15:46
* dhellmann suddenly feels old15:46
*** emagana has quit IRC15:46
asettleHhhahaha well, I was busy in 1995 much like yourself. My agenda was just slightly different.15:46
asettleLess, html and more, speaking15:46
asettleA busy time indeed15:46
*** yangyapeng has quit IRC15:49
*** andreas_s has quit IRC15:52
openstackgerritIldiko Vancsa proposed openstack/training-guides master: [upstream] Add trainers' guide to the web page  https://review.openstack.org/47781715:52
AJaegerasettle: how long do you wait for the OPS guide to get migrated to wiki before you call it a failure? ;)15:55
asettleAJaeger: hahahhahaha15:55
asettleHmmm15:55
asettleStraight away? :p15:55
* AJaeger is very suspicious that nobody will do it - but if a miracle happens, good15:55
asettleI think we both know I'll end up doing it15:55
annegentleasettle AJaeger :)15:55
asettleo/ annegentle15:56
AJaegerasettle: NO! don't do it! If nobody volunteers, then nobody is really interested and it would be just another dead place.15:56
asettleAJaeger: you're right there15:56
asettleThen we just... delete it?15:56
asettleWhat would be next steps?15:56
AJaegerdelete it.15:56
asettleAlright15:57
annegentleHey, the new search for the docs site work on docs-draft, correct? I don't think it works for me locally, but I'm not sure why.15:57
asettleSounds excellent to me15:57
annegentleyeah, delete it asettle15:57
AJaegerWe can always resurrect it from git if needed15:57
annegentletechnically put it in the attic or some such but yes15:57
annegentleAJaeger ayuop15:57
asettleannegentle: actually I get the google one in docs-draft... weird15:57
AJaegerasettle: send a reminder in two weeks or so asking, then announce we retire it...15:57
openstackgerritDoug Hellmann proposed openstack/openstackdocstheme master: move documentation from readme to sphinx tree  https://review.openstack.org/47820515:57
asettleAJaeger: okay, will do15:57
annegentleasettle depends on the patchset, if it's using 1.11.0 theme version15:57
asettleOhhhh15:58
asettleHmm15:58
asettleannegentle: yes the new search works in the doc site work on docs-draft :)15:58
asettleJust confirming15:58
annegentleasettle thanks for checking!15:59
asettlenp, you had me second guessing there15:59
annegentleasettle something's up locally and not sure it really matters other than I have to test after it's on gerrit15:59
asettleWeird.15:59
asettleOkay, up and up15:59
*** emagana has joined #openstack-doc16:00
*** emagana has quit IRC16:01
*** emagana has joined #openstack-doc16:01
*** chlong has joined #openstack-doc16:05
*** chlong has quit IRC16:05
*** emagana has quit IRC16:05
*** pcaruana has quit IRC16:09
*** thorst has joined #openstack-doc16:11
*** vijaykc4 has quit IRC16:12
openstackgerritAnne Gentle proposed openstack/openstackdocstheme master: move documentation from readme to sphinx tree  https://review.openstack.org/47820516:15
*** lucasxu has joined #openstack-doc16:16
*** dustins has quit IRC16:27
*** lucasxu has quit IRC16:29
*** lucasxu has joined #openstack-doc16:30
*** yangyapeng has joined #openstack-doc16:35
*** yangyapeng has quit IRC16:40
*** tesseract has quit IRC16:40
*** ericyoung has quit IRC16:41
*** jpena is now known as jpena|off16:46
AJaegerannegentle: sorry, can't help much with the docstheme. Hope others can...16:47
AJaegerannegentle: I'll try when I find time - but don't depend too heavily on me, please16:47
*** lucasxu has quit IRC16:49
*** donghao has quit IRC16:55
*** yangyapeng has joined #openstack-doc16:57
*** amotoki is now known as amotoki_away16:57
*** yangyapeng has quit IRC17:02
*** lucasxu has joined #openstack-doc17:12
*** vijaykc4 has joined #openstack-doc17:26
*** vijaykc4 has quit IRC17:28
*** vijaykc4 has joined #openstack-doc17:28
*** _jarvis has joined #openstack-doc17:29
*** tosky has quit IRC17:30
*** rbowen has quit IRC17:42
*** yamamoto has quit IRC17:42
*** rbowen has joined #openstack-doc17:43
*** yamamoto has joined #openstack-doc17:43
*** yamamoto has quit IRC17:50
*** pkovar has quit IRC17:56
*** dustins has joined #openstack-doc18:03
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: update contributor guide based on changes after migration project  https://review.openstack.org/47762418:03
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: merge all manuals into one sphinx build  https://review.openstack.org/47819018:03
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: remove networking guide  https://review.openstack.org/47818818:03
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: add redirects from docs.o.o/project/ to the latest build  https://review.openstack.org/47818918:03
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: add a link to the shared install guide  https://review.openstack.org/47765218:03
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: fix schema to guard against misnamed properties  https://review.openstack.org/47695718:11
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: templatize the list of api reference guides  https://review.openstack.org/47695818:11
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: move library data from openstack-projects.html to projects.yaml  https://review.openstack.org/47625218:11
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: update contributor guide based on changes after migration project  https://review.openstack.org/47762418:11
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: set up template rendering to support multiple series  https://review.openstack.org/47725018:11
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: remove networking guide  https://review.openstack.org/47818818:11
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: show install guides in order by service description, like we do elsewhere  https://review.openstack.org/47724918:11
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: add redirects from docs.o.o/project/ to the latest build  https://review.openstack.org/47818918:11
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: group projects from the same team together in template data file  https://review.openstack.org/47724818:11
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: add a link to the shared install guide  https://review.openstack.org/47765218:11
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: add service-type redirects  https://review.openstack.org/47626218:11
openstackgerritAnne Gentle proposed openstack/openstackdocstheme master: move documentation from readme to sphinx tree  https://review.openstack.org/47820518:12
*** shaunm has joined #openstack-doc18:23
*** yamamoto has joined #openstack-doc18:27
openstackgerritAnne Gentle proposed openstack/openstackdocstheme master: Adds list of versions in the "Updated" bar  https://review.openstack.org/47763918:28
*** _jarvis has quit IRC18:35
*** yamamoto has quit IRC18:35
openstackgerritAnne Gentle proposed openstack/openstackdocstheme master: Adds list of versions in the "Updated" bar  https://review.openstack.org/47763918:35
openstackgerritAnne Gentle proposed openstack/openstackdocstheme master: move documentation from readme to sphinx tree  https://review.openstack.org/47820518:37
*** salv-orl_ has joined #openstack-doc18:37
openstackgerritAnne Gentle proposed openstack/openstackdocstheme master: Adds list of versions in the "Updated" bar  https://review.openstack.org/47763918:38
*** salv-orlando has quit IRC18:40
*** vijaykc4 has quit IRC18:40
openstackgerritAnne Gentle proposed openstack/openstackdocstheme master: Adds list of versions in the "Updated" bar  https://review.openstack.org/47763918:44
*** yamamoto has joined #openstack-doc18:50
*** yamamoto has quit IRC18:50
*** pkovar has joined #openstack-doc19:10
*** salv-orl_ has quit IRC19:11
*** salv-orlando has joined #openstack-doc19:12
*** salv-orlando has quit IRC19:16
AJaegerannegentle: could you look at the servicename in https://review.openstack.org/477899 , please?19:36
annegentleAJaeger yup yup19:44
*** yamamoto has joined #openstack-doc19:51
AJaegerthanks19:53
*** yamamoto has quit IRC19:59
openstackgerritAnne Gentle proposed openstack/openstackdocstheme master: Adds list of versions in the "Updated" bar  https://review.openstack.org/47763920:00
*** pkovar has quit IRC20:10
*** salv-orlando has joined #openstack-doc20:14
openstackgerritMerged openstack/openstackdocstheme master: move documentation from readme to sphinx tree  https://review.openstack.org/47820520:16
openstackgerritTreva Nichole Williams proposed openstack/openstack-manuals master: Removed duplicate line under Benefits section, per bug #1700821.  https://review.openstack.org/47825320:19
openstackbug 1700821 in openstack-manuals "Networking concepts, same point duplicated" [Undecided,New] https://launchpad.net/bugs/1700821 - Assigned to Treva Nichole Williams (trilliams)20:19
AJaegerannegentle: I see tags in 477639 ;)20:20
AJaegerannegentle: for testing I changed the theme.conf to "show_other_versions = True"20:21
annegentleAJaeger ah, tabs?20:21
*** thorst has quit IRC20:21
AJaegerthe versions are on the right, let me produce a screenshot..20:21
AJaegerhttp://paste.opensuse.org/2342952320:22
AJaegersee below the "Bug icon"20:22
annegentleAJaeger yeah that's what I'm working on now, to get those to collapse into a drop-down menu using CSS only20:22
AJaegerso, functionality works - just ugly ;)20:22
annegentleAJaeger banging my head against css20:23
annegentleright20:23
* AJaeger is not a CSS expert and cannot help20:23
annegentleAJaeger it's like this: http://2.bp.blogspot.com/-X6peGqFZFZ0/UcTqFQ2O21I/AAAAAAAAPi0/uRJyfIgg9uo/s320/blindssuck.gif20:23
AJaegerLOL20:28
openstackgerritIldiko Vancsa proposed openstack/training-guides master: [upstream] Add trainers' guide to the web page  https://review.openstack.org/47781720:30
AJaegerdhellmann: https://docs.openstack.org/openstackdocstheme/latest/ is up, so unified publishing works20:39
*** dustins has quit IRC20:41
*** yangyapeng has joined #openstack-doc20:45
*** lucasxu has quit IRC20:48
*** yangyapeng has quit IRC20:50
openstackgerritAndreas Jaeger proposed openstack/openstack-doc-tools master: Switch to openstackdocstheme  https://review.openstack.org/47827520:52
openstackgerritAndreas Jaeger proposed openstack/openstack-doc-tools master: Switch to openstackdocstheme  https://review.openstack.org/47827520:59
dhellmannAJaeger : woot!21:00
openstackgerritAnne Gentle proposed openstack/openstackdocstheme master: Adds list of versions in the "Updated" bar  https://review.openstack.org/47763921:01
AJaegerdhellmann: one other item for the todo list: Support for storyboard.openstack.org instead of launchpad - the report a bug link goes to launchpad but infra, monasca etc use storyboard instead21:02
dhellmannAJaeger : I'll add that to the future list21:03
AJaegerthanks.21:03
* AJaeger calls it a day and waves good night21:03
dhellmannAJaeger : although you could open a bug for annegentle ;-)21:03
*** rbowen has quit IRC21:04
*** annegentle has quit IRC21:07
*** thorst has joined #openstack-doc21:36
*** thorst has quit IRC21:42
*** annegentle has joined #openstack-doc21:54
annegentleshoot I really need that build working on openstackdocstheme for html, right now it just produces a PDF21:58
annegentleearly enough for an ianychoi ?21:59
openstackgerritIldiko Vancsa proposed openstack/training-guides master: [upstream] Add trainers' guide to the web page  https://review.openstack.org/47781722:08
*** thorst has joined #openstack-doc22:16
*** thorst has quit IRC22:17
annegentleianychoi see if this is right https://review.openstack.org/47830622:23
annegentleand now time for me to head out22:23
* annegentle waves22:23
*** annegentle has quit IRC22:23
*** rbowen has joined #openstack-doc22:33
*** yangyapeng has joined #openstack-doc22:45
*** yangyapeng has quit IRC22:50
*** rbowen has quit IRC23:11
*** charcol has joined #openstack-doc23:33
openstackgerritKendall Nelson proposed openstack/training-guides master: [upstream] Add OUI Best Practices  https://review.openstack.org/47831923:48
*** s-shiono has joined #openstack-doc23:49
*** thorst has joined #openstack-doc23:51
*** thorst has quit IRC23:52
« Monday, 2017-06-26 Index Wednesday, 2017-06-28 »

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