Friday, 2017-06-30

*** masaki has joined #openstack-doc00:02
*** amotoki is now known as amotoki_away00:17
*** amotoki_away is now known as amotoki00:18
*** amotoki is now known as amotoki_away00:27
*** junbo has quit IRC00:45
*** junbo has joined #openstack-doc00:49
*** johnthetubaguy has quit IRC00:56
*** johnthetubaguy has joined #openstack-doc00:57
*** phuongnh has joined #openstack-doc00:59
*** dmacpher-afk has quit IRC01:02
*** amotoki_away is now known as amotoki01:23
*** thorst has joined #openstack-doc01:33
*** thorst has quit IRC01:38
*** thorst has joined #openstack-doc01:52
*** thorst has quit IRC01:53
*** lucasxu has joined #openstack-doc01:54
*** s-shiono has joined #openstack-doc01:58
openstackgerritMerged openstack/openstackdocstheme master: Require bug_project setting  https://review.openstack.org/47905002:11
*** donghao has joined #openstack-doc02:25
*** donghao has quit IRC02:32
*** salv-orlando has joined #openstack-doc03:02
*** yamamoto has joined #openstack-doc03:05
*** salv-orlando has quit IRC03:07
*** skelso has joined #openstack-doc03:13
*** gouthamr has quit IRC03:25
*** skelso has quit IRC03:45
openstackgerritChason Chan proposed openstack/openstack-manuals master: remove content migrated to openstack/neutron repo  https://review.openstack.org/47913003:53
*** thorst has joined #openstack-doc03:54
*** thorst has quit IRC04:00
openstackgerritChason Chan proposed openstack/openstack-manuals master: remove content migrated to openstack/neutron repo  https://review.openstack.org/47913204:01
*** salv-orlando has joined #openstack-doc04:03
openstackgerritChason Chan proposed openstack/openstack-manuals master: remove content migrated to openstack/neutron repo  https://review.openstack.org/47913004:04
*** salv-orlando has quit IRC04:08
*** lucasxu has quit IRC04:30
*** masaki has quit IRC04:37
*** masaki has joined #openstack-doc04:37
*** oanson has quit IRC04:53
AJaegeramotoki: /i18n/latest04:58
amotokiAJaeger: thanks!04:58
openstackgerritAndreas Jaeger proposed openstack/openstackdocstheme master: Adds list of versions in the "Updated" bar  https://review.openstack.org/47763905:00
openstackgerritAndreas Jaeger proposed openstack/openstackdocstheme master: Adds list of versions in the "Updated" bar  https://review.openstack.org/47763905:03
*** salv-orlando has joined #openstack-doc05:04
*** tdasilva has quit IRC05:04
*** salv-orlando has quit IRC05:08
openstackgerritAndreas Jaeger proposed openstack/openstackdocstheme master: Update docs  https://review.openstack.org/47914705:11
*** salv-orlando has joined #openstack-doc05:15
*** caoyuan has joined #openstack-doc05:16
*** edmondsw_ has joined #openstack-doc05:17
*** edmondsw has quit IRC05:19
openstackgerritMerged openstack/openstack-manuals master: Always set bug_project  https://review.openstack.org/47905105:22
*** tdasilva has joined #openstack-doc05:29
*** rcernin has joined #openstack-doc05:45
*** thorst has joined #openstack-doc05:55
*** thorst has quit IRC06:00
*** jpena|off is now known as jpena06:18
*** igordcard has quit IRC06:20
*** donghao has joined #openstack-doc06:20
*** igordcard has joined #openstack-doc06:20
*** salv-orlando has quit IRC06:21
*** salv-orlando has joined #openstack-doc06:21
*** salv-orlando has quit IRC06:26
*** phuongnh has quit IRC06:27
*** phuongnh has joined #openstack-doc06:28
*** salv-orlando has joined #openstack-doc06:28
*** de9nie has joined #openstack-doc06:31
*** s-shiono has quit IRC06:38
AJaegerdhellmann, asettle, annegentle, the openstackdocstheme always adds a "Creative commons" copyright - is that really correct?06:44
*** pcaruana has joined #openstack-doc06:45
*** suyog has quit IRC06:46
*** charcol has quit IRC06:57
*** tesseract has joined #openstack-doc07:14
*** masaki has quit IRC07:24
*** masaki has joined #openstack-doc07:24
openstackgerritAndreas Jaeger proposed openstack/openstackdocstheme master: Make Creative Commons License optional  https://review.openstack.org/47919407:33
*** phuongnh has quit IRC07:39
*** gouthamr has joined #openstack-doc07:39
*** donghao has quit IRC07:48
*** thorst has joined #openstack-doc07:57
*** de9nie has quit IRC08:00
*** thorst has quit IRC08:03
*** egallen has joined #openstack-doc08:11
*** pnavarro has joined #openstack-doc08:13
csatariAn install guide question: is it OK to add the install guide of a python client (which is in a separate repo) to the install guide of the main project?08:16
AJaegercsatari: those are normally two different personas - the operator for the service, a user for the python client.08:18
AJaegerAlso, installation of the client should be trivial,  isn't it?08:18
AJaegerWe have generic install instructions for all of the clients...08:18
AJaegercsatari: otherwise I see no reason - I'm just puzzled why to write a whole guide for a client...08:19
*** salv-orl_ has joined #openstack-doc08:19
*** salv-orlando has quit IRC08:23
*** salv-orl_ has quit IRC08:24
asettleAJaeger: yes I do believe we write a creative commons on the theme08:26
AJaegerasettle: right now we have it - but that looks wrong to me for nova documents. It would be a change of licnese. That's why I proposed 479194 - and want annegentle's guideance on it.08:29
asettleAJaeger: reviewing08:30
asettleThat looks... about right? Although definitely need Anne to look at that08:32
*** pblaho has joined #openstack-doc09:04
csatariAJaeger: I would like to avoid to write a whole guide for a client. I just would like to add one or two additional lies to the existing guide. This is why I asked :)09:18
AJaegerI would just add the two lines to the client document - since that's where people expect it.09:23
AJaegerBut your call09:23
*** thorst has joined #openstack-doc09:24
*** tosky has joined #openstack-doc09:28
*** thorst has quit IRC09:29
openstackgerritAlexandra Settle proposed openstack/openstack-manuals master: add a link to the shared install guide  https://review.openstack.org/47765209:33
*** yamamoto has quit IRC09:35
asettlecsatari: the client document would make more sense, tbh. But if you think it won't interrupt the user experience, go for it.09:36
*** yamamoto has joined #openstack-doc09:36
*** phuongnh has joined #openstack-doc09:37
*** yamamoto has quit IRC09:38
*** yamamoto has joined #openstack-doc09:42
*** yamamoto has quit IRC09:42
openstackgerritAndreas Jaeger proposed openstack/openstack-manuals master: Remove fuel references  https://review.openstack.org/47923109:45
*** yamamoto has joined #openstack-doc09:46
*** masaki has quit IRC09:46
asettleBahahhahahaha AJaeger how good is your HTML?09:49
AJaegerasettle: Trial and error? ;)09:50
asettleAJaeger: oh, so as good as mine then09:50
asettleI'm having a good old laugh here09:50
asettleI'm working on: https://review.openstack.org/#/c/477652/6/www/project-install-guide/draft/index.html09:50
asettleTo make the index a little more friendly, prettier, and so it adds the new link as Doug's original patch09:50
asettleAll is well in the hood until I saw the build09:50
asettlehttp://docs-draft.openstack.org/52/477652/6/check/gate-openstack-manuals-tox-doc-publish-checkbuild/d7f0d6c//publish-docs/www/project-install-guide/draft/index.html09:51
asettleAnd I am laughing like a maniac. I don't know how I turned it black.09:51
*** yamamoto has quit IRC09:51
AJaegerThere's a missing </div> - let me comment09:51
asettleAJaeger: OH!09:51
asettleokay you have so much more 'trial and error' than I do.09:51
AJaegerasettle: I know that you need to close everything you open ;)09:52
AJaegerwow, really nice! Just looked at the published doc. Cool! ;)09:52
asettleAJaeger: hhahaha yeah. I guess I just got too excited and did not check properly09:53
asettleHAHAHAHAHA09:53
asettleit's black :(09:53
openstackgerritAlexandra Settle proposed openstack/openstack-manuals master: add a link to the shared install guide  https://review.openstack.org/47765209:53
asettleOkay, fixed up those divs. Hopefully we get a proper build now.09:53
* AJaeger wonders which color now...09:56
asettleHhahhaha please hold10:02
*** cathrich_ has quit IRC10:02
*** cathrichardson has joined #openstack-doc10:03
asettleAJaeger: IT FIXED IT!10:05
asettleHuzzah!10:06
asettlehttp://docs-draft.openstack.org/52/477652/7/check/gate-openstack-manuals-tox-doc-publish-checkbuild/713ad29//publish-docs/www/project-install-guide/draft/index.html10:06
AJaegerthat looks boring ;)10:06
* AJaeger is glad that he remememberd how to count ;)10:06
openstackgerritAlexandra Settle proposed openstack/openstack-manuals master: add a link to the shared install guide  https://review.openstack.org/47765210:07
asettleAJaeger: yep, beautifully boring. Wonderful. I think we'll have to save our black coloured pages for another time :p10:07
asettleYou're an excellent counter, AJaeger . I recommend putting on your resume10:07
AJaeger:)10:08
asettleAnyway *dusts off hands* I'm very happy with my results here10:10
*** yamamoto has joined #openstack-doc10:10
*** yamamoto has quit IRC10:12
AJaegerindeed!10:13
*** yamamoto has joined #openstack-doc10:13
*** yamamoto has quit IRC10:16
*** yamamoto has joined #openstack-doc10:16
*** yamamoto has quit IRC10:18
*** thorst has joined #openstack-doc10:20
*** caoyuan has quit IRC10:24
*** thorst has quit IRC10:24
*** thorst has joined #openstack-doc10:44
*** thorst has quit IRC10:44
*** skelso has joined #openstack-doc10:46
*** yamamoto has joined #openstack-doc10:52
*** skelso has quit IRC10:52
*** pkovar has joined #openstack-doc11:03
*** thorst has joined #openstack-doc11:10
*** thorst has quit IRC11:11
*** amotoki is now known as amotoki_away11:11
asettledhellmann: since I figure you'll be up and at 'em shortly for your meetings: https://review.openstack.org/#/c/477652/11:14
asettleVoila! I kept the text, and divided it. Similar to how we structured the other pages. Defined it as "tutorial" vs. "project install guides"11:15
asettleI think that's pretty adequate :)11:15
*** gouthamr has quit IRC11:26
*** jpena is now known as jpena|lunch11:33
*** yamamoto has quit IRC11:34
*** yamamoto has joined #openstack-doc11:36
*** yamamoto has quit IRC11:58
*** thorst has joined #openstack-doc12:00
*** thorst has quit IRC12:00
*** nishaYadav has joined #openstack-doc12:06
*** phuongnh has quit IRC12:06
*** thorst has joined #openstack-doc12:16
*** thorst has quit IRC12:16
*** amotoki_away is now known as amotoki12:19
*** yamamoto has joined #openstack-doc12:26
*** jpena|lunch is now known as jpena12:29
*** cathrich_ has joined #openstack-doc12:48
*** salv-orlando has joined #openstack-doc12:50
*** cathrichardson has quit IRC12:50
*** caoyuan has joined #openstack-doc12:50
dhellmannasettle, AJaeger : o/12:51
AJaegergood morning, dhellmann12:51
dhellmannasettle : look sgood12:54
*** yamamoto has quit IRC12:55
dhellmannit will be good to start landing that series so we can make these changes more easily12:55
*** donghao has joined #openstack-doc12:56
*** salv-orlando has quit IRC12:56
*** yamamoto has joined #openstack-doc12:56
*** pkovar has quit IRC12:57
*** yamamoto has quit IRC13:01
*** nishaYadav has quit IRC13:02
*** lucasxu has joined #openstack-doc13:04
*** nishaYadav has joined #openstack-doc13:07
*** nishaYadav is now known as Guest6697713:07
asettlemorning dhellmann :)13:08
asettledhellmann: okay, on your mark....13:08
* dhellmann braces himself13:08
*** Dinesh_Bhor has quit IRC13:09
dhellmannasettle, AJaeger : do you think it makes sense to tag HEAD of openstack-manuals as something like "before-migration" to make it easier for folks to find the old content when we land those patches that delete it? that's probably a terrible name, but you get the idea13:11
*** skelso has joined #openstack-doc13:11
asettleHmmm, dhellmann would we remove that tag after everything settles down? It might actually make for a good indicator/marker for people in the future13:16
openstackgerritAndreas Jaeger proposed openstack/clouddocs-maven-plugin master: Retire repo  https://review.openstack.org/47930013:19
*** Guest66977 is now known as nishaYadav_13:19
dhellmannasettle : I'm not sure we actually have a way to remove tags (it's not something we do for version tags)13:19
asettleokay, just checking :) Cause I think if we use the tag, we should stick to it and not remove it.13:19
dhellmannthe infra team probably could, if we really wanted to. although keeping it forever probably does make sense13:20
dhellmannyeah13:20
dhellmannI should have permission to push that, so if you think it's a good idea we can bikeshed on the name and I can do it13:20
asettledhellmann: please just go ahead haha. I don't think bikesheding on names has led us anywhere particular13:20
openstackgerritAndreas Jaeger proposed openstack/clouddocs-maven-plugin master: Retire repo  https://review.openstack.org/47930013:21
dhellmannok, going ahead with "before-migration"13:21
dhellmanndone13:23
*** thorst has joined #openstack-doc13:23
*** pkovar has joined #openstack-doc13:24
AJaegerdhellmann: go ahead and add something...13:24
AJaegerwe cannot remove tags - with the distributed nature of git, you keep them anyway13:24
asettleYeah that's cool :)13:25
asettleBecause we've gone for BM does this mean we can go for something like.... After...Delivery just to keep in theme?13:25
asettleWe should have gone for like "before-changes"13:25
dhellmannI thought about "ante-diaspora" but that seemed too obscure13:26
asettleHeh!13:30
asettleI would have liked to have seen that, but yes, sadly, rather obscure13:30
*** salv-orlando has joined #openstack-doc13:34
AJaegerasettle: we can retire clouddocs-maven-plugin - we do not use it anymore on any branches. See https://review.openstack.org/479300 and my email as well13:39
asettleYes I replied to your email :) it LGTM. I did have one thought - will retiring this impact being able to pull down and build the old tags?13:40
asettleThe ones with XML?13:40
AJaegerasettle: ah, thanks!13:41
AJaegerasettle: you need the released package for that.13:41
AJaegerasettle: we never build from git. So, everything should be fine...13:41
asettleSweet as, just wanted to check :)13:41
*** salv-orlando has quit IRC13:43
*** pnavarro has quit IRC13:47
*** pblaho has quit IRC13:48
*** annegentle has joined #openstack-doc13:58
*** xiaofandh12 has joined #openstack-doc13:58
*** yamamoto has joined #openstack-doc13:58
*** donghao has quit IRC14:01
*** dmacpher has joined #openstack-doc14:04
*** amotoki is now known as amotoki_away14:04
*** annegentle has quit IRC14:07
*** yamamoto has quit IRC14:10
*** annegentle has joined #openstack-doc14:11
AJaegermorning, annegentle !14:11
annegentleAJaeger hey, you're my favorite person this morning! Thanks for the cleanup14:12
AJaegerannegentle: the other way round - I'm waiting for you ;)14:12
annegentleAJaeger ha, still logging in to everything :)14:13
AJaegerannegentle: https://review.openstack.org/479194 is the one change I need your guidance on.14:13
AJaegerannegentle: openstackdocstheme by default says everything is Creative Commons - which is wrong IMHO for nova etc. So, I made this configurable. Do you agree?14:14
annegentleAJaeger yeah, I saw that... I'm mulling it over because it sorta gets into legal territory, right? I mean, we don't have super great clarity on the license even though I've tried to engage...14:14
annegentleAJaeger here's the thing. Docs are CC by 4.0. Code is Apache 2.0. What I've asked the lawyers to give us is a statement that says that, that we can reuse. This is what some companies do. But it's a bit complex, ya know?14:15
annegentleAJaeger so I never got full buy in.14:15
annegentleAJaeger and what we have now is what we ended up with.14:15
AJaegerThere's only an Apache licencse file in most repos, so having openstackstheme say Creative commons sounds wrong.14:15
annegentleAJaeger but it's not wrong for the output14:15
annegentleAJaeger and that's where the difficulty lies14:15
AJaegerannegentle: Docs are CC 3.0 - according to openstacktheme14:15
annegentleAJaeger the source, the output, etc14:15
annegentleAJaeger ah, sorry, yes, I have to get out the old emails -- and I even went to a board meeting.14:16
annegentleAJaeger hm14:16
AJaegerannegentle: even openstack-manuals has an Apache LICENSE file ;(14:16
annegentleAJaeger I'm not sure how to know what's "right"14:16
annegentleAJaeger yep14:16
annegentleAJaeger it's all quite gray area14:16
AJaegerannegentle: if you manage to dig into that, it would be really great...14:17
annegentleAJaeger the config ref "could" be all Apache14:17
annegentleAJaeger but I don't want to :)14:17
annegentleAJaeger and I've done it a lot over the years14:17
annegentleAJaeger to the end we have now, you know?14:17
annegentleAJaeger it's not worth digging in again and again is it?14:17
AJaegerannegentle: no, it's not. I would not change the status quo.14:17
AJaegerBUT using openstackdocstheme puts a big CC 3.0 on each published document. And that looked really wrong to me.14:18
annegentleAJaeger trying to think of one next step... need to noodle on it more.14:18
annegentleAJaeger but it could be right -- because of brand obligations.14:18
annegentleAJaeger that's the part I'm unsure of.14:18
annegentleAJaeger and what legal protections are we even trying to ensure?14:18
AJaegerannegentle: so, my idea was: Make the CC 3.0 a sign in option. continue to use it in openstack-manuals etc. But other projects won't have it14:19
AJaegerasettle: still around? Please read backscroll ^14:19
asettleAJaeger: oh whoah yeah I am. Just in afternoon meetings. Will look :)14:19
annegentleAJaeger just because the doc source moves, why would the license change? Because of Apache already existing? This is the area I already tried to explain multiple times.14:19
annegentleAJaeger because code is Apache, docs are CC.14:19
annegentleAJaeger so the solution I'd like is: put both in the footer14:20
annegentleAJaeger because technically it is both14:20
AJaegerannegentle: let's take cloudkitty. It does not get any import from us. Should their docs license change since they switch from oslosphinx to openstackdocstheme?14:20
AJaegerannegentle: you're right, there's the other question what happens if we move networking guide from one repo to another - has that any license implications. I wasn't going to touch that...14:20
annegentleAJaeger yes. Because of a memo from oh 2012 or so they should have switched their doc license already.14:20
annegentleAJaeger I can look up the papertrail if that helps14:21
AJaegerdo we have that in our archives?14:21
AJaegerthen I'll just abandon my change and don't spend a minute more on this14:22
annegentleAJaeger to me this is just compliance, it's just that I have to find the papertrail for compliance docs14:23
annegentleAJaeger I wouldn't honestly. It's a rabbit hole I've been down many times.14:23
annegentleAJaeger ohhh now I have it. We would need a second CLA for docs.14:24
annegentleAJaeger at least that was one proposal14:25
annegentleAJaeger and we never settled on a "real" solution14:25
*** gouthamr has joined #openstack-doc14:26
annegentleAJaeger but this is the official approval of CC By for docs https://wiki.openstack.org/wiki/Governance/Foundation/15Oct2012BoardMinutes#Approval_of_the_CCBY_License_for_Documentation14:26
AJaegerOh, what a rabbit hole14:28
openstackgerritAnne Gentle proposed openstack/openstackdocstheme master: Adds list of versions in the "Updated" bar  https://review.openstack.org/47763914:28
*** pnavarro has joined #openstack-doc14:42
*** sjain_ has joined #openstack-doc14:46
sjain_dhellmann: I needed some help with oslo.config plugin about which you commented here https://review.openstack.org/#/c/474543/314:47
sjain_Is it needed for importing the files in tables directory?14:47
sjain_and is it used somewhere from which I can take some reference14:48
AJaegerasettle, annegentle: Shall I abandon 479194 for now?14:55
*** nishaYadav_ has quit IRC14:55
*** sjain_ has quit IRC14:55
annegentleAJaeger To take a single next step, one of us (you, me, or asettle ) can log a support request with the Foundation for a way forward (or if we simply keep the theme as-is).14:57
annegentleAJaeger I can take it on (since I doubt you really want to, ha ha) or asettle if you'd like the experience/understanding, you can do it.14:58
annegentleasettle I think the request is, "can we keep the theme as is? or add Apache2 wording?" but there's no other action we would want to take on14:59
annegentleAJaeger asettle  does that make sense?14:59
*** sjain_ has joined #openstack-doc15:00
AJaegerannegentle: yes15:01
AJaegerannegentle: once 477639  is merged, I'd like to see a release of openstackdocstheme done...15:02
annegentleand asettle I know it's a kick-responsibility-down-the-road of me to ask you to put in the request, but you are the most knowledgeable of the migration right now.15:02
annegentleAJaeger me too!15:03
AJaeger;)15:04
AJaegerannegentle: the links are broken now - http://docs-draft.openstack.org/39/477639/17/check/gate-openstackdocstheme-docs-ubuntu-xenial/a2dc7f3//doc/build/pathto(ver,%201)%20%7D%7D15:05
annegentleAJaeger yep trying next syntax idea now15:06
AJaegerannegentle: I think you missed the {{ before pathto15:06
openstackgerritAnne Gentle proposed openstack/openstackdocstheme master: Adds list of versions in the "Updated" bar  https://review.openstack.org/47763915:06
annegentleAJaeger oh i see it now15:07
*** rcernin has quit IRC15:11
asettleSorry guys - I'll catch up shortly, meetings all afternoon15:13
AJaegeron a Friday? ;(15:15
asettleYerpppp15:15
AJaegerannegentle: write up your docs and then let's merge ;)15:16
*** rbowen has quit IRC15:16
annegentleAJaeger yeah!15:17
*** sjain_ has quit IRC15:17
AJaegerget it in today, prepare the rleease and do it on Monday ;)15:17
annegentleAJaeger I'm off next week, I'll try to get it done today - docs and release patch15:18
* AJaeger will review later, now off for a bit.15:19
AJaegerannegentle: enjoy your vacation!15:19
openstackgerritbruce-benjamin proposed openstack/openstack-manuals master: [User-guide] Add support for booting from an encrypted volume  https://review.openstack.org/47934615:27
openstackgerritMerged openstack/openstackdocstheme master: Adds list of versions in the "Updated" bar  https://review.openstack.org/47763915:27
*** jpena is now known as jpena|off15:31
*** nishaYadav has joined #openstack-doc15:33
openstackgerritJames E. Blair proposed openstack/openstackdocstheme master: Increase admonition.important contrast  https://review.openstack.org/47935515:37
annegentle^^ will look momentarily15:38
*** sjain has joined #openstack-doc15:39
asettleokayyyy I"m back15:41
*** spotz_ is now known as spotz15:42
annegentlehey asettle15:44
*** sjain__ has joined #openstack-doc15:45
dhellmannasettle : should I go ahead and remove my -2 from https://review.openstack.org/#/c/475395 so you can merge it monday, or do you want to wait until I'm up in the morning?15:46
*** sjain has quit IRC15:46
asettlehey annegentle so - I'm sending a support request to the Foundation regarding our licensing because of the changes in theme?15:47
openstackgerritAnne Gentle proposed openstack/openstackdocstheme master: Adds docs for release versions dropdown menu  https://review.openstack.org/47936015:47
annegentleasettle more because of moving the source to a place where the docs previously indicated Apache215:48
annegentleasettle if you don't think you quite have the nuance for the ask, I can make the request. It's complicated.15:48
asettledhellmann: let's wait for monday before everyone else wakes up (you're normally awake before most people in the US)15:48
asettleannegentle: I admit I don't believe I understand the nuances at all, but I perhaps should. What's the urgency here?15:48
asettleCan we talk about it on Monday or could you maybe CC me so I can read and ensure I'm following along?15:49
annegentleasettle I'd like to leave as-is, but Andreas brought up a good point that it's a change in license footer.15:49
annegentleasettle I'm off all next week.15:49
dhellmannasettle : ok, I'll set my alarm again ;-)15:49
asettledhellmann: thanks :D15:49
annegentleasettle I find it low risk to take no action also.15:49
asettleannegentle: oh right! Okay, so you want to get this done today?15:49
asettleannegentle: okay, shall we set up a meeting for when you return and we can make sure we dive into it?15:49
annegentleasettle putting the request in today means you're putting it in, since I'm off :)15:49
annegentleasettle hm. thinking.15:50
annegentleI don't want to delay the migration because of licensing.15:50
annegentleasettle is license ambiguity already listed on the "problems list?"15:51
asettleannegentle: no, but we can add it?15:51
annegentleasettle yep15:51
asettlehttps://etherpad.openstack.org/p/doc-future-problems15:51
asettlePlease add :D15:51
dhellmannthe docs used the apache2 license?15:52
annegentleasettle added.15:52
asettleannegentle: gracias15:52
annegentledhellmann looking at the footer of oslosphinx what would you say?15:52
dhellmannI don't see a license on https://docs.openstack.org/developer/reno/15:53
dhellmannmaybe it's me, but I would interpret any license statement in a document about software to apply to the software unless it explicitly said "this documentation is licensed..."15:54
dhellmannbut I definitely agree we want to be clear on that, and explicit is better15:55
dhellmannannegentle : I wonder if we can fix up the theme to avoid issues like I'm seeing in the contents summary section on http://docs-draft.openstack.org/84/449584/2/check/gate-nova-docs-ubuntu-xenial/ecf883b//doc/build/html/configuration/config.html15:57
annegentledhellmann what is the issue?15:57
dhellmannon my 27" monitor I have to scroll an entire screen height to get to any content15:58
dhellmannthere are so many sections on that page...15:58
dhellmannmaybe that in itself is the problem and we need to render it differently15:58
asettleNot a great render16:00
dhellmannyeah, some of that is going to need to be changed in oslo.config16:00
asettleannegentle: okay so we've added to the list, we'll sort when you return. I mean, I can easily send a support request but I admit I"m not too sure what I'm going to say :)16:00
annegentleasettle yeah it's dicy16:01
annegentledicey even16:01
asettleHahha I get you ;)16:01
asettleYeah, I don't know what I want to say.16:01
asettleNeed to say*16:01
annegentledhellmann I saw a different issue :)16:01
annegentledhellmann content chunking is the issue you see, I believe. Slice the actual content would be my suggested fix.16:02
dhellmannannegentle : the actual content also needs to be fixed, but that's all rendered automatically16:02
dhellmannI'd also like to remove the smooth scrolling thing because that makes it impossible to give someone a direct link to a section of a page.16:02
dhellmannor at least harder16:02
dhellmannok, errand time, bbiab16:03
annegentledhellmann yeah there's a related different issue that could give you anchor tags I think... click on one of the long entries to see what I mean.16:03
annegentledhellmann yep, I get what you're seeing16:03
*** sjain__ has quit IRC16:04
openstackgerritAnne Gentle proposed openstack/openstackdocstheme master: Adds docs for release versions dropdown menu  https://review.openstack.org/47936016:05
*** tesseract has quit IRC16:11
*** pnavarro has quit IRC16:16
*** sjain_ has joined #openstack-doc16:22
openstackgerritAnne Gentle proposed openstack/openstackdocstheme master: Increase admonition.important contrast  https://review.openstack.org/47935516:23
annegentleasettle can I get a +2 on https://review.openstack.org/479360 - then I can set it up for release16:27
asettleannegentle: you got it16:27
asettleYou want a 2a?16:27
openstackgerritAnne Gentle proposed openstack/openstackdocstheme master: Increase admonition.important contrast  https://review.openstack.org/47935516:36
*** thorst has quit IRC16:39
*** sjain_ has quit IRC16:39
openstackgerritAnne Gentle proposed openstack/openstackdocstheme master: Increase admonition.important contrast  https://review.openstack.org/47935516:40
annegentleasettle nah, just +2, let AJaeger have another crack at it, he's a sharp cookie :)16:41
asettleCool cool16:43
*** xiaofandh12 has quit IRC16:46
asettleOkay dudes I'm out o/16:50
*** nishaYadav_ has joined #openstack-doc17:04
*** nishaYadav has quit IRC17:04
openstackgerritAnne Gentle proposed openstack/openstackdocstheme master: Increase admonition.important contrast  https://review.openstack.org/47935517:07
*** skelso has quit IRC17:10
*** skelso has joined #openstack-doc17:10
AJaegerannegentle: should we merge the change above and prepare release? ^17:17
openstackgerritMerged openstack/openstackdocstheme master: Adds docs for release versions dropdown menu  https://review.openstack.org/47936017:18
AJaegerannegentle: could you review https://review.openstack.org/#/c/479147/ as well, a small docs update17:18
*** pnavarro has joined #openstack-doc17:30
AJaegerdhellmann: still around? what do you think of https://review.openstack.org/#/c/479147/ and https://review.openstack.org/479355 ? Once those two are in, I'd like to cut a new release (on Monday probably)17:30
*** rbowen has joined #openstack-doc17:34
*** rbowen has quit IRC17:34
*** rbowen has joined #openstack-doc17:34
*** sjain_ has joined #openstack-doc17:36
*** nishaYadav_ has quit IRC17:42
*** pcaruana has quit IRC17:42
AJaegerdhellmann: you duplicated some work for trove/troveclient since those patches used topic "docs-migration", I adjusted topics now17:43
*** tosky has quit IRC17:44
*** sjain_ has quit IRC17:48
*** rbowen has quit IRC17:50
*** rbowen has joined #openstack-doc17:50
dhellmannAJaeger : back, looking17:54
*** thorst has joined #openstack-doc17:55
openstackgerritMerged openstack/openstackdocstheme master: Increase admonition.important contrast  https://review.openstack.org/47935517:58
annegentleAJaeger will get Jim's color contrast change in 1.12.0 too, make sure I got the sha right: https://review.openstack.org/47938117:58
openstackgerritMerged openstack/openstackdocstheme master: Update docs  https://review.openstack.org/47914717:59
*** sjain has joined #openstack-doc18:03
*** pkovar has quit IRC18:05
AJaegerannegentle, dhellmann thanks18:06
annegentleAJaeger feel free to change the release sh as needed to get https://review.openstack.org/479147 in the 1.12.0 rel18:07
AJaegerannegentle: will check and fix if needed18:12
AJaegerannegentle: updated the hash, we're ready now.18:15
annegentleAJaeger thanks18:16
AJaegerdhellmann: https://review.openstack.org/#/c/479381 is ready for the next release round ;)18:16
annegentleAJaeger oh I was getting the wrong hash anyway! Thanks for the help.18:17
annegentleAJaeger once I got it from git log, once I got it from Gerrit, log was the way to go.18:17
*** skelso has quit IRC18:18
AJaegerannegentle: get it from http://git.openstack.org/cgit/openstack/openstackdocstheme/commit/18:18
annegentleAJaeger from the commit, got it18:19
annegentleAJaeger as a favor, do you have a moment to look at https://review.openstack.org/#/c/461280/ ? I'm flailing a bit and have been for a while... got some help but now need more...18:19
*** skelso has joined #openstack-doc18:20
AJaegerannegentle: quick fix - let me download...18:21
AJaegerI meant: qucik suggestion to fix build18:22
annegentleAJaeger ok thanks18:24
annegentleAJaeger I prolly need more understanding of how the actual scripts work to generate reports -- but will see what you think18:25
AJaegerannegentle: I never used those ;(18:27
dhellmannAJaeger : unless it's critical, I'll do that early Monday18:27
AJaegerdhellmann: not critical.18:27
dhellmannack18:27
AJaegerMonday is fine18:27
AJaegerthanks, dhellmann18:28
*** jpena|off is now known as jpena18:29
AJaegerannegentle: I cannot even invoke this, seems to hang ;(18:32
annegentleAJaeger yeah... what did I do wrong? ! :)18:32
*** thorst has quit IRC18:33
AJaegerannegentle: no idea - looks more like I cannot authenticate...18:33
annegentleAJaeger hmm is my invocation correct?18:34
annegentleAJaeger or at least, the way I think this thing should be run correct?18:34
AJaegeryou call get_changes with not enough parmeters, I get:18:35
AJaegerget_changes() takes at least 3 arguments (1 given)18:35
AJaegerlooking into it...18:35
annegentleAJaeger thanks, I thought I fixed that particular one. Fixed that py35 error, wouldn't have caught that myself, ty!18:35
*** sjain has quit IRC18:36
AJaegerannegentle: http://paste.openstack.org/show/614215/18:45
annegentleAJaeger oo! So should I change the labels to make it more "docs-descriptive?"18:46
AJaegerannegentle: should I push my changes?18:46
annegentleAJaeger yes, please do! I want to learn.18:46
annegentleAJaeger does the data from the query look accurate?18:47
annegentleAJaeger oh well I can figure that out myself :) thank you so much.18:47
annegentleAJaeger had me stumped18:47
AJaegerannegentle: the gerrit query looked fine at least ;)18:47
annegentleAJaeger lol18:47
annegentleAJaeger it's all that pesky Python glue :)18:48
AJaegerannegentle: note that with the change of pathes that dhellmann is working on, these need to be done in the reviewers tool as well...18:48
annegentleAJaeger ah, yes, good point.18:48
dhellmann?18:48
annegentleAJaeger I wanted a baseline to start from18:48
annegentleAJaeger maybe a before and after18:48
AJaegerannegentle: sure...18:48
annegentledhellmann oh I'm getting help with that review-stats patch.18:48
*** jpena is now known as jpena|away18:48
annegentledhellmann trying to see what doc contributor stats look like18:48
dhellmannah18:48
annegentledhellmann if there are any insights18:48
annegentledhellmann beyond just my curiosity18:49
AJaegerdhellmann: if we move install-guide around, then the review-stats tool needs to look at new pathes18:49
AJaegerdhellmann: nothing for you to do ;)18:49
dhellmannok, whew18:49
dhellmannI wasn't sure what you meant :-)18:49
annegentle:) dhellmann hey man I already helped us dodge that license bullet bill18:49
AJaegerannegentle: I'll call it a weekend now, hope this helped a bit.18:49
* AJaeger waves good bye18:50
dhellmannAJaeger : have a good weekend18:50
annegentleAJaeger awesome.18:50
annegentleAJaeger helps me! Thanks18:50
AJaegerdhellmann, annegentle, enjoy the (long) weekend18:50
dhellmannannegentle : where do we stand on unofficial projects using openstackdocstheme?18:53
annegentledhellmann they can't, it's a brand violation, right?18:54
dhellmannthat's what I thought, but I wanted to make sure18:54
annegentledhellmann yeah18:54
dhellmannhttps://review.openstack.org/#/c/478370/418:54
AJaegerdhellmann: I handed a few -1s out already...18:55
dhellmannAJaeger : yes, I noticed those, too18:55
dhellmannI thought you were gone, or I would have asked you :-)18:55
AJaegerslowly gone ;)18:56
openstackgerritMerged openstack/openstackdocstheme master: Enable some off-by-default checks  https://review.openstack.org/47630818:59
*** egallen_ has joined #openstack-doc19:19
*** cathrichardson has joined #openstack-doc19:20
*** egallen has quit IRC19:22
*** egallen_ is now known as egallen19:22
*** cathrich_ has quit IRC19:22
*** laurelm has quit IRC19:24
*** thorst has joined #openstack-doc20:08
*** annegentle has quit IRC20:38
*** thorst has quit IRC20:46
*** lucasxu has quit IRC20:47
*** pnavarro has quit IRC20:51
*** skelso has quit IRC21:05
*** edmondsw_ has quit IRC21:14
*** skelso has joined #openstack-doc21:16
*** skelso has quit IRC21:28
*** jpena|away is now known as jpena|off21:36
*** cathrichardson has quit IRC22:01
*** cathrichardson has joined #openstack-doc22:02
*** thorst has joined #openstack-doc22:02
*** thorst has quit IRC22:07
*** laurelm has joined #openstack-doc22:17
*** rbowen has quit IRC22:23
*** egallen has quit IRC22:23
*** dmacpher has quit IRC22:55
*** dmacpher has joined #openstack-doc23:09

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