Friday, 2017-07-14

« Thursday, 2017-07-13 Index Saturday, 2017-07-15 »
*** masaki has joined #openstack-doc00:02
*** suyog has joined #openstack-doc00:03
*** thorst has joined #openstack-doc00:08
*** gmann has quit IRC00:12
*** gmann has joined #openstack-doc00:12
openstackgerrityanghuichan proposed openstack/api-site master: Use https instead of http  https://review.openstack.org/48324500:44
*** dmacpher has joined #openstack-doc00:46
*** thorst has quit IRC00:47
openstackgerrityanghuichan proposed openstack/api-site master: Use https instead of http  https://review.openstack.org/48324500:49
*** masaki has quit IRC00:54
*** masaki has joined #openstack-doc00:54
*** cathrich_ has joined #openstack-doc01:22
*** cathrichardson has quit IRC01:22
*** caoyuan has joined #openstack-doc01:23
*** masaki has quit IRC01:27
*** masaki has joined #openstack-doc01:32
*** masaki has quit IRC01:35
*** masaki has joined #openstack-doc01:36
*** caoyuan_ has joined #openstack-doc02:00
*** caoyuan has quit IRC02:04
*** masaki has quit IRC02:08
*** mriedem has quit IRC02:43
*** masaki has joined #openstack-doc02:47
*** thorst has joined #openstack-doc02:48
*** masaki is now known as masaki|lunch02:49
*** thorst has quit IRC02:53
*** gouthamr has joined #openstack-doc02:54
*** ykarel has joined #openstack-doc03:12
openstackgerritRyan Liang proposed openstack/openstack-manuals stable/ocata: Unity:Update storops version and note for backup  https://review.openstack.org/48328803:17
*** gouthamr has quit IRC03:28
*** amotoki_away is now known as amotoki03:41
*** s-shiono has joined #openstack-doc04:05
*** fragatin_ has joined #openstack-doc04:06
*** fragatin_ has quit IRC04:09
*** fragatin_ has joined #openstack-doc04:09
*** fragatina has quit IRC04:10
*** gouthamr has joined #openstack-doc04:13
*** fragatin_ has quit IRC04:14
*** dmacpher has quit IRC04:21
*** fragatina has joined #openstack-doc04:28
*** fragatina has quit IRC04:29
*** fragatina has joined #openstack-doc04:29
*** fragatina has quit IRC04:29
*** fragatina has joined #openstack-doc04:29
*** sridhar_ram has joined #openstack-doc04:36
*** dmacpher has joined #openstack-doc04:38
*** thorst has joined #openstack-doc04:49
*** thorst has quit IRC04:54
*** gouthamr has quit IRC05:11
*** hyakuhei has quit IRC05:11
*** larainema has quit IRC05:27
*** rcernin has joined #openstack-doc05:52
*** nicolasbock has joined #openstack-doc05:53
*** andreas_s has joined #openstack-doc05:58
*** tylerderosagrund has joined #openstack-doc06:03
*** dmacpher_ has joined #openstack-doc06:04
*** dmacpher_ has quit IRC06:04
*** tylerderosagrund has quit IRC06:07
*** augusts has quit IRC06:07
*** amotoki is now known as amotoki_away06:08
*** pcaruana has joined #openstack-doc06:25
*** amotoki_away is now known as amotoki06:33
openstackgerritRyan Liang proposed openstack/openstack-manuals stable/ocata: Unity:Update storops version and note for backup  https://review.openstack.org/48328806:36
*** suyog has quit IRC06:45
*** thorst has joined #openstack-doc06:50
*** thorst has quit IRC06:55
openstackgerritOpenStack Proposal Bot proposed openstack/openstack-manuals stable/newton: Imported Translations from Zanata  https://review.openstack.org/48383906:59
*** amotoki is now known as amotoki_away07:02
openstackgerritOpenStack Proposal Bot proposed openstack/openstack-manuals stable/ocata: Imported Translations from Zanata  https://review.openstack.org/48384107:03
*** charcol has quit IRC07:13
*** tesseract has joined #openstack-doc07:14
*** dmacpher has quit IRC07:21
openstackgerritOpenStack Proposal Bot proposed openstack/training-guides master: Imported Translations from Zanata  https://review.openstack.org/48384907:25
*** alexchadin has joined #openstack-doc07:25
*** amotoki_away is now known as amotoki07:35
*** Aqsa has joined #openstack-doc07:51
*** vijaykc4 has joined #openstack-doc08:03
*** thorst has joined #openstack-doc08:51
*** thorst has quit IRC08:56
*** andreas_s has quit IRC08:56
*** andreas_s has joined #openstack-doc08:56
*** amotoki is now known as amotoki_away08:59
*** amotoki_away is now known as amotoki08:59
*** s-shiono has quit IRC08:59
*** fragatina has quit IRC09:02
*** fragatina has joined #openstack-doc09:02
*** masaki|lunch has quit IRC09:03
*** alexchadin has quit IRC09:08
*** amotoki is now known as amotoki_away09:09
*** amotoki_away is now known as amotoki09:10
*** amotoki is now known as amotoki_away09:25
*** amotoki_away is now known as amotoki09:28
openstackgerritMerged openstack/openstack-manuals stable/newton: Imported Translations from Zanata  https://review.openstack.org/48383909:36
openstackgerritMerged openstack/openstack-manuals stable/ocata: Imported Translations from Zanata  https://review.openstack.org/48384109:37
*** tylerderosagrund has joined #openstack-doc09:39
*** tylerderosagrund has quit IRC09:43
openstackgerritMerged openstack/api-site master: Use https instead of http  https://review.openstack.org/48324509:45
*** tosky has joined #openstack-doc09:55
*** pcaruana has quit IRC09:56
openstackgerritMerged openstack/training-guides master: Imported Translations from Zanata  https://review.openstack.org/48384909:57
*** caoyuan_ has quit IRC10:03
*** Aqsam has joined #openstack-doc10:03
*** pcaruana has joined #openstack-doc10:09
bretonhi10:16
bretonany idea why aodh docs are broken? https://docs.openstack.org/aodh/latest/10:16
bretonthe front page works but all links give 40410:16
AJaegerbreton: do those work when reviewing a change?10:19
AJaegerbreton: http://docs-draft.openstack.org/61/476261/4/gate/gate-aodh-docs-ubuntu-xenial/b3a2245//doc/build/html/ seems to work fine10:20
AJaegerbreton: so, looks like the publishing job somehow failed - let's merge something for aodh and review again, please10:20
AJaegerbreton: https://review.openstack.org/#/c/482955/ is a candidate ;)10:20
bretonAJaeger: thank you, added myself there10:21
AJaegerbreton: you could also check the post log files10:21
AJaegerhttp://logs.openstack.org/1b/1b78978cbab3f16bf0542edf70fa3ddd2b3a4551/post/aodh-docs-unified-ubuntu-xenial/10:22
AJaegerthis looks like an infra publishing problem - so better ask on #openstack-infra10:23
AJaegerbut I don't see anything obvious ;(10:24
bretonAJaeger: understood, thanks10:24
*** vijaykc4 has quit IRC10:40
*** thorst has joined #openstack-doc10:52
*** thorst has quit IRC10:57
*** vijaykc4 has joined #openstack-doc10:58
*** pcaruana has quit IRC11:25
*** thorst has joined #openstack-doc11:27
*** thorst has quit IRC11:30
*** nle5223__ has joined #openstack-doc11:33
*** Aqsa has quit IRC11:35
*** Aqsam has quit IRC11:36
*** nle5223__ has quit IRC11:36
*** d0ugal has joined #openstack-doc11:36
*** nle5223__ has joined #openstack-doc11:36
*** Aqsa has joined #openstack-doc11:37
*** d0ugal has quit IRC11:39
*** d0ugal has joined #openstack-doc11:40
*** d0ugal has quit IRC11:40
*** d0ugal has joined #openstack-doc11:40
*** thorst has joined #openstack-doc11:42
*** vijaykc4 has quit IRC11:43
*** d0ugal has quit IRC11:44
*** vijaykc4 has joined #openstack-doc11:45
*** tylerderosagrund has joined #openstack-doc11:47
*** thorst has quit IRC11:47
*** dustins has joined #openstack-doc11:50
*** andreas_s has quit IRC11:50
*** pkovar has joined #openstack-doc12:02
*** amotoki is now known as amotoki_away12:02
*** caoyuan has joined #openstack-doc12:22
*** thorst has joined #openstack-doc12:33
asettleaspiers and csatari - I know you guys have a million things on your mind that are not HA related, but dhellmann and I were discussing the two folders for the guide12:36
asettleOriginally we were hoping for the new structure to be finalised by Pike, but that doesn't look like it's going to happen12:36
asettleWhat do you both think?12:36
*** thorst has quit IRC12:43
*** tylerder_ has joined #openstack-doc12:48
*** tylerderosagrund has quit IRC12:48
openstackgerritMerged openstack/openstack-manuals stable/ocata: Unity:Update storops version and note for backup  https://review.openstack.org/48328812:50
*** mriedem has joined #openstack-doc12:57
csatariasettle, dhellmann: I can put some effort to the HA guide. Do we have a spec for what should be done?12:58
asettlecsatari: http://specs.openstack.org/openstack/docs-specs/specs/ocata/improve-ha-guide.html12:58
asettleWe wrote this up a while ago12:58
asettleBut aspiers had a full list of things we needed to move around for the restructure12:58
asettleThis spec is rather out of date in comparison to what we wanted to achieve in the end12:59
csatariasettle: You mean this one: https://etherpad.openstack.org/p/HA_Guide ?13:00
asettleWHY COULDNT I FIND THAT13:00
asettleYes, csatari that's the one13:01
asettleWe were implementing that new structure in ha-guide-draft13:01
*** nicolasbock_ has joined #openstack-doc13:04
*** nicolasbock has quit IRC13:04
*** Aqsa has quit IRC13:05
*** nle5223__ has quit IRC13:05
*** Aqsa has joined #openstack-doc13:06
*** Aqsam has joined #openstack-doc13:06
*** tylerder_ is now known as tylerderosagrund13:06
*** tylerderosagrund has quit IRC13:06
*** tylerderosagrund has joined #openstack-doc13:06
*** gouthamr has joined #openstack-doc13:07
*** amotoki_away is now known as amotoki13:16
*** dustins has quit IRC13:18
*** Dinesh_Bhor has quit IRC13:26
openstackgerritAlexandra Settle proposed openstack/openstack-manuals master: Removing the ops-guide from openstack-manuals  https://review.openstack.org/48393713:30
*** donghao has joined #openstack-doc13:33
AJaegerdhellmann: let's remove the aodh install checks (remove the links to them for now?) until they publish a new version13:35
dhellmannAJaeger : I haven't looked into the issue; was there a problem with the CI system, the job, or their content?13:36
dhellmannI saw your link to the log earlier, but have been in meetings this morning13:37
dhellmannwow, tons of import errors building the docs13:37
openstackgerritAlexandra Settle proposed openstack/openstack-manuals master: Addsd "last updated" info to the ha-guide  https://review.openstack.org/48393813:37
*** catintheroof has joined #openstack-doc13:40
AJaegerdhellmann: just check any recent openstack-manuals change...13:40
AJaegerdhellmann: nothing urgent to merge...13:40
dhellmannAJaeger : oh, I meant the cause on the aodh side13:41
*** larainema has joined #openstack-doc13:41
dhellmannAJaeger : yeah, I will prepare a patch to openstack-manuals to turn off the flag13:44
openstackgerritAlexandra Settle proposed openstack/openstack-manuals master: Addsd "last updated" info to the ha-guide  https://review.openstack.org/48393813:44
AJaegerdhellmann: they need to merge a chnage...13:50
dhellmannAJaeger : so their build will work, they just need to land a patch?13:50
AJaegerdhellmann: yes, that's my hope ;) Looking at the logs13:50
asettleAJaeger and dhellmann - just to clarify, this will most likely be failing due to the aodh stuff? https://review.openstack.org/#/c/483937/13:51
dhellmannasettle : probably. I'm working on that patch right now13:51
asettleThanks dhellmann :)13:51
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: disable linking to aodh install guide  https://review.openstack.org/48394113:52
* AJaeger just pinged aodh and gordc imported the translations. so, let's wait an hour for the change to merge13:52
dhellmannasettle , AJaeger : ^^13:52
AJaegerthis is the aodh one: https://review.openstack.org/#/c/482955/13:52
dhellmannok, cool13:52
asettleI seeee13:52
asettleJeez this is fun13:52
AJaegerdhellmann: yep, that should move us forward - so once your change is in, we can revert it hopefully soon ;)13:53
dhellmannI'll go ahead and file a revert with a depends-on for the translations patch, too13:54
AJaegereta for aodh is 37 mins - plus publishing, so we could just wait ...13:54
aspiersasettle: I'm on vacation but IIRC the thing we need is that google sheet made by iphutch13:54
AJaeger(if there's nothing urgent)13:54
AJaegerbbl13:54
asettleaspiers: do you still have it?13:54
asettleNever mind, I'm just really great at searching for shit13:55
asettlecsatari and aspiers - https://docs.google.com/spreadsheets/d/1hw4axU2IbLlsjKpz9_EGlKQt0S6siViik7ETjNg_MgI/edit#gid=013:55
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: Revert "disable linking to aodh install guide"  https://review.openstack.org/48394213:55
asettleSorry: https://docs.google.com/spreadsheets/d/1hw4axU2IbLlsjKpz9_EGlKQt0S6siViik7ETjNg_MgI/edit?usp=sharing13:55
aspiersgood find!13:56
*** pcaruana has joined #openstack-doc13:56
asettleaspiers: super good at searching through the cloud13:56
aspiersyay for the cloud13:56
*** cathrichardson has joined #openstack-doc13:57
*** cathrich_ has quit IRC13:59
openstackgerritAlexandra Settle proposed openstack/openstack-manuals master: Addsd "last updated" info to the ha-guide  https://review.openstack.org/48393814:02
*** xiaofandh12 has joined #openstack-doc14:03
*** donghao has quit IRC14:05
asettledhellmann: want this merged?14:10
asettlehttps://review.openstack.org/#/c/483941/14:10
*** vijaykc4 has quit IRC14:19
dhellmannasettle : it should be ok to do that. AJaeger was saying we could wait until https://review.openstack.org/#/c/482955/ merges to see if that fixes the aodh docs14:22
asettleOh I misunderstood that. Okay, let's wait :014:23
dhellmannI already pushed the revert, so it would be quick for us to toggle back and forth, but I'm fine with waiting, too14:23
asettle:)*14:23
*** yamamoto has quit IRC14:36
*** yamamoto has joined #openstack-doc14:40
*** thorst has joined #openstack-doc14:43
*** emagana has joined #openstack-doc14:45
*** chlong has joined #openstack-doc14:48
*** thorst has quit IRC14:48
AJaegerhttps://docs.openstack.org/aodh/latest/install/index.html is up - so, let's recheck14:48
asettleAJaeger: all the patches?14:49
AJaegerasettle: one as a start14:49
asettleAJaeger: rechecked my two14:49
asettleThe HA one should come in faster14:49
*** yamamoto has quit IRC14:51
*** sjain_ has joined #openstack-doc14:59
*** lucasxu has joined #openstack-doc14:59
asettleAJaeger: failed :(15:01
asettlehttps://review.openstack.org/#/c/483938/15:01
csatariasettle, aspiers: Thanks I will check them and do some usefull on monday. Any hints where to start?15:01
dhellmannAJaeger, annegentle, asettle : I have proposed a new doc theme release for early next week: https://review.openstack.org/#/c/483961/15:01
sjain_dhellmann: when I run tox -e docs on the keystone master branch, I'm getting this error http://paste.openstack.org/show/615121/15:02
sjain_strangely, its just with me and the jenkins test passed when it was marged15:03
sjain_*merged15:03
sjain_and for other developers it is fine15:03
dhellmannhmm15:03
dhellmannoh, probably the python version15:04
asettlecsatari: start at the beginning, I'm afraid15:04
dhellmannsjain_ : the job runs "tox -e venv -- python setup.py build_sphinx" which uses a different virtualenv than the "docs" env you're using15:04
asettleJust go :015:04
asettle:) *15:04
asettleThanks  dhellmann15:04
dhellmannsjain_ : tox allows you to set "base_python" (or maybe it's "basepython") to control which version of python an env uses. Does keystone have docs set to run on python 3?15:05
*** rcernin has quit IRC15:05
sjain_I don't know, probably not15:05
csatariasettle: oookay :)15:05
AJaegerasettle: that's a different error.15:06
asettlecsatari: yep, haha sorry, not helpful15:06
sjain_but I tried deleting the virtual env and started fresh, it is still giving the same error15:06
asettleAJaeger: ohhhhh now it's all gravy. I see it.15:06
dhellmannsjain_ : what do you get if you run ".tox/docs/bin/python --version" ?15:06
AJaegerasettle: you remove a document and don't reference it15:06
openstackgerritPetr Kovar proposed openstack/openstack-manuals master: Remove the user-guide  https://review.openstack.org/48270315:06
AJaegerasettle: update doc/ha-guide/source/compute-node-ha.rst as well15:07
sjain_dhellmann: Python 3.5.215:07
dhellmannthat's interesting15:07
dhellmannsjain_ : is your system configured with python3 by default?15:07
dhellmannor maybe you have tox installed for python3?15:08
dhellmannin any case, that's the problem15:08
dhellmannthe CI system has python 2 by default15:08
AJaegerdhellmann, asettle : for openstackdocstheme, what about taking in https://review.openstack.org/483493 as well?15:08
openstackgerritAlexandra Settle proposed openstack/openstack-manuals master: Added "last updated" info to the ha-guide  https://review.openstack.org/48393815:08
sjain_no it should be python2.7 i think15:08
dhellmannsjain_ : that's a bug in oslo.config, so you could report a bug at https://bugs.launchpad.net/oslo.config15:08
AJaegerdhellmann, asettle : Not sure about https://review.openstack.org/48327515:08
dhellmannsjain_ : what do you get when you run "python --version"?15:08
asettleAJaeger: I have referenced it in the commit?15:09
sjain_dhellmann: without virtualenv right?15:09
dhellmannsjain_ : let me start again. How do you run "tox"?15:09
dhellmannis it just "tox ..." or do you have it in a virtualenv?15:09
AJaegerasettle: LGTM now ;)15:09
sjain_in the virtualenv15:09
sjain_I do source env/bin/activate15:10
dhellmannAJaeger : I'd be happy to have that patch included. It's mine, so we need someone else to approve.15:10
asettleAJaeger: yeah juts needed to fix the cmopute note file15:10
* dhellmann looks at asettle ^^15:10
sjain_and then tox -e docs15:10
asettledhellmann: what what15:10
asettlewhat15:10
asettlewhat what15:10
AJaegerasettle: 48393815:10
dhellmannsjain_ : ok. then let's see which version of python is the default inside that virtualenv by running the "python --version" with the env activated15:10
dhellmannasettle : https://review.openstack.org/#/c/483493/15:10
sjain_dhellmann: Python 2.7.1215:11
dhellmannhrm15:11
asettledhellmann: +2A15:11
AJaegerasettle: yes, 483493 - dhellmann is right, I mistyped15:11
dhellmannsjain_ : and tox is in that virtualenv?15:11
AJaegerasettle, I think https://review.openstack.org/483275 can wait - I'm not feeling confident enough to +2 that myself but if others are, go ahead...15:12
sjain_dhellmann: oh may be not, ugh15:12
asettleAJaeger: lemme look15:12
sjain_which tox gives me /usr/bin/tox15:12
dhellmannsjain_ : aha!15:13
dhellmannsjain_ : maybe that was installed via a deb?15:13
sjain_might be, I can't recall now, it was a while ago15:14
dhellmannor rpm -- system package of some sort (I don't know what OS you're on)15:14
sjain_I'll purge or uninstall and then check15:14
sjain_I can't recall whether I did pip or apt install15:14
sjain_but I think I understood the error15:15
openstackgerritMerged openstack/openstackdocstheme master: add a comment to all output HTML pages showing the input file  https://review.openstack.org/48349315:15
sjain_I'll purge and reinstall again, this time in virtualenv15:15
* AJaeger will be back later15:16
sjain_dhellmann: Thanks, I'll try that :)15:16
dhellmannsjain_ : you could also file a bug against oslo.config, because we need to fix this. If you're interested in tackling the fix, I can work with you on it.15:17
sjain_I'm happy to do that, but is it really a bug?15:17
dhellmannoh, yes, definitely15:17
sjain_I mean I was using tox directly from the system15:18
dhellmannthe problem is that we're returning a None value in a place where we need to be returning a string15:18
dhellmannyour system configuration uncovered the problem, but didn't cause it15:18
sjain_oh that, yeah sure15:18
dhellmannso all of that discussion was just about understanding how your system was different from the CI system :-)15:18
sjain_I checked, the error was in sort function15:18
sjain_hmm right the core issue was with the none value15:19
sjain_yeah sure I can help you on this15:19
dhellmannok, great!15:19
dhellmannso, first step is filing the bug and assigning it to yourself. Then we can dig into the code and figure out where to replace those nones with strings15:20
dhellmannbrb15:20
sjain_I think before line 279, or at 233 adding a check here https://github.com/openstack/oslo.config/blob/master/oslo_config/sphinxext.py15:22
sjain_dhellmann: I'll file the bug and assign it15:22
sjain_to myself15:23
*** yamamoto has joined #openstack-doc15:23
*** caoyuan has quit IRC15:38
dhellmannsjain_ : that would be one way to do it. The None means to use the "DEFAULT" group, though, so we may be able to do something lower-level in the option discovery code to ensure that the data is always valid15:39
*** sjain_ has quit IRC15:39
asettledhellmann: sending an email to ops list re ops guide deletion15:42
dhellmannasettle : ack15:42
*** Aqsam has quit IRC15:48
*** Aqsa has quit IRC15:48
*** ykarel has quit IRC15:56
*** jeblair has quit IRC16:09
*** jeblair has joined #openstack-doc16:11
openstackgerritMerged openstack/openstack-manuals master: add TEMPLATE_FILE to the top of some more pages  https://review.openstack.org/48310916:22
openstackgerritMerged openstack/openstack-manuals master: add "last updated" info to arch-design guide  https://review.openstack.org/48352516:22
openstackgerritMerged openstack/openstack-manuals master: limit install guide list to services  https://review.openstack.org/48348616:22
*** mriedem is now known as mriedem_lunch16:26
*** emagana has quit IRC16:30
*** emagana has joined #openstack-doc16:31
*** emagana_ has joined #openstack-doc16:32
*** emagana has quit IRC16:32
*** fragatina has quit IRC16:38
*** ykarel has joined #openstack-doc16:44
*** edmondsw has joined #openstack-doc16:46
*** edmondsw has quit IRC16:49
*** ykarel has quit IRC16:49
*** shaunm has quit IRC17:00
*** fragatina has joined #openstack-doc17:05
*** dustins has joined #openstack-doc17:11
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: require all projects to have published docs  https://review.openstack.org/48400317:20
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: skip redirects when code name matches service type  https://review.openstack.org/48400417:20
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: be consistent with how we list libraries  https://review.openstack.org/48400517:20
*** tosky has quit IRC17:24
*** annegentle has joined #openstack-doc17:40
*** pcaruana has quit IRC17:41
*** fragatina has quit IRC17:43
*** fragatina has joined #openstack-doc17:44
*** tosky has joined #openstack-doc17:48
*** dustins has quit IRC17:53
*** ykarel has joined #openstack-doc18:00
*** pkovar has quit IRC18:01
*** yamamoto has quit IRC18:03
*** yamamoto has joined #openstack-doc18:03
*** yamamoto has quit IRC18:04
*** mriedem_lunch is now known as mriedem18:11
*** mriedem has left #openstack-doc18:12
*** mriedem has joined #openstack-doc18:12
*** ykarel has quit IRC18:15
*** spotz has quit IRC18:33
*** edmondsw has joined #openstack-doc18:34
*** edmondsw has quit IRC18:39
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: skip redirects when code name matches service type  https://review.openstack.org/48400418:43
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: be consistent with how we list libraries  https://review.openstack.org/48400518:43
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: require all projects to have published docs  https://review.openstack.org/48400318:43
*** spotz has joined #openstack-doc18:45
*** lucasxu has quit IRC18:47
*** shaunm has joined #openstack-doc18:49
*** Aqsa has joined #openstack-doc18:57
*** Aqsam has joined #openstack-doc18:57
*** yamamoto has joined #openstack-doc19:05
*** tylerderosagrund has quit IRC19:07
*** nicolasbock_ has quit IRC19:15
*** yamamoto has quit IRC19:17
jungleboyjdhellmann:  Is there a way to do a tox -e docs and just process the docstrings in a particular file?19:41
*** fragatin_ has joined #openstack-doc19:45
smcginnisjungleboyj: Maybe temporarily modify the tox.ini target to limit the directory where it's parsing?19:45
*** fragatina has quit IRC19:48
*** thorst has joined #openstack-doc19:50
*** tylerderosagrund has joined #openstack-doc19:51
dhellmannjungleboyj, smcginnis : I'm not aware of one19:52
* jungleboyj is sad19:53
dhellmannyou have to have 1 good build with the doctrees cached in order for sphinx to even think it doesn't have to build everything19:53
dhellmannyeah, me, too19:53
dhellmannmaybe we can build something19:53
jungleboyjI can always work on things in parallel.19:53
jungleboyjJust wanted to know if there might be a faster way.19:54
jungleboyjI will play around a bit more too.19:54
dhellmannwe could make hacking smart enough to detect parsing errors in docstrings, but sphinx is going to catch things like bad cross-references that require building all of it19:55
*** tylerderosagrund has quit IRC19:56
*** catintheroof has quit IRC20:01
jungleboyjOk, well, maybe I will re-enable warnings so that it will at least stop when it hits the next round of warnings.20:03
jungleboyjThat will speed up the process a bit.20:03
*** Aqsam has quit IRC20:03
*** Aqsa has quit IRC20:03
*** tylerderosagrund has joined #openstack-doc20:06
*** edmondsw has joined #openstack-doc20:07
*** xiaofandh12 has quit IRC20:11
*** fragatin_ has quit IRC20:19
*** fragatina has joined #openstack-doc20:19
*** thorst has quit IRC20:20
*** cathrichardson has quit IRC20:20
*** cathrichardson has joined #openstack-doc20:20
*** thorst has joined #openstack-doc20:21
*** thorst has quit IRC20:25
*** rbowen has quit IRC20:39
*** rbowen has joined #openstack-doc20:44
*** phil_h has quit IRC20:56
*** annegentle has quit IRC20:56
*** gouthamr has quit IRC21:00
*** annegentle has joined #openstack-doc21:03
*** annegentle has quit IRC21:04
*** rbowen has quit IRC21:06
*** chlong has quit IRC21:19
*** edmondsw has quit IRC21:24
*** gouthamr has joined #openstack-doc21:29
*** fragatin_ has joined #openstack-doc21:59
*** fragatina has quit IRC22:02
*** emagana_ has quit IRC22:02
jungleboyjdhellmann:  So, another question.  Is there a way to exclude a file from sphinx processing?22:21
*** d0ugal has joined #openstack-doc22:29
*** gouthamr has quit IRC22:30
*** fragatin_ has quit IRC22:53
*** fragatina has joined #openstack-doc22:53
*** edmondsw has joined #openstack-doc22:57
*** edmondsw has quit IRC23:02
*** tosky has quit IRC23:05
*** nicolasbock_ has joined #openstack-doc23:23
dhellmannjungleboyj : yes, you can use http://www.sphinx-doc.org/en/stable/config.html?highlight=exclude#confval-exclude_patterns23:29
dhellmannjungleboyj : however, it's sometimes simpler to rename the file to .txt instead of .rst. It depends on what you're doing with the file.23:30
dhellmannjungleboyj : if the file contains the autodoc instructions for a module, you can also tell pbr not to generate that file23:31
dhellmannjungleboyj : see autodoc_exclude_modules in https://docs.openstack.org/pbr/latest/user/using.html23:31
jungleboyjdhellmann:  This isn't an rst.  It is the auto generated cinder/opts.py file.23:31
dhellmannjungleboyj : ok, for that you want the pbr option23:31
dhellmannI think you'd set it to cinder.opts23:31
jungleboyjSo I am assuing that it is getting pulled in looking for docstrings and it is puking on things like [BACKEND]23:32
dhellmannlikely23:33
jungleboyjSo I would add autodoc_tree_excludes or something like that?23:34
jungleboyjdhellmann:  Thanks for the pointer.  I will play around with that.23:34
openstackgerritDoug Hellmann proposed openstack/openstackdocstheme master: remove smooth scrolling  https://review.openstack.org/48407723:35
dhellmannjungleboyj : yeah, let me find you an example23:35
dhellmannjungleboyj : I've been using it to skip documenting test classes: http://codesearch.openstack.org/?q=autodoc_exclude_modules&i=nope&files=&repos=23:36
jungleboyjdhellmann:  Awesome.  You are a rockstar!23:37
dhellmannnah, I can't even carry a tune23:37
* dhellmann remembers its the weekend and steps back away from the computer23:37
jungleboyj:-)   On that note, I am going to call it a night.  Talk to you next week.23:38
* jungleboyj needs to do the same.23:38
« Thursday, 2017-07-13 Index Saturday, 2017-07-15 »

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