Friday, 2017-08-04

*** rbowen has joined #openstack-doc00:10
*** thorst_afk has joined #openstack-doc00:11
*** catintheroof has quit IRC00:14
*** gmann has quit IRC00:17
*** gmann has joined #openstack-doc00:17
*** efoley has quit IRC00:18
*** yangyapeng has quit IRC00:20
*** yangyapeng has joined #openstack-doc00:20
*** yangyapeng has quit IRC00:24
*** ujuc has joined #openstack-doc00:26
*** ujuc has quit IRC00:31
*** dmacpher has joined #openstack-doc00:36
*** rbowen has quit IRC00:52
*** thorst_afk has quit IRC00:52
*** suyog has quit IRC00:54
*** phuongnh has joined #openstack-doc01:05
*** suyog has joined #openstack-doc01:07
*** yangyapeng has joined #openstack-doc01:19
*** ujuc has joined #openstack-doc01:20
*** masaki has joined #openstack-doc01:25
*** ekcs has quit IRC01:36
*** phuongnh has quit IRC01:40
*** phuongnh has joined #openstack-doc01:41
*** edmondsw has joined #openstack-doc01:42
*** skelso has joined #openstack-doc01:42
*** thorst_afk has joined #openstack-doc01:42
*** edmondsw has quit IRC01:46
*** phuongnh has quit IRC02:02
*** phuongnh has joined #openstack-doc02:03
*** mriedem1 is now known as mriedem02:05
*** thorst_a_ has joined #openstack-doc02:18
*** thorst_a_ has quit IRC02:18
*** http_GK1wmSU has joined #openstack-doc02:20
*** thorst_afk has quit IRC02:20
*** http_GK1wmSU has left #openstack-doc02:23
*** s-shiono has joined #openstack-doc02:39
*** ujuc has quit IRC02:40
*** ujuc has joined #openstack-doc02:55
openstackgerritChason Chan proposed openstack/openstack-manuals master: Update the usage of openstack-doc-tools  https://review.openstack.org/49072503:23
*** khushbu has joined #openstack-doc03:29
*** ujuc has quit IRC03:29
*** edmondsw has joined #openstack-doc03:30
*** ekcs has joined #openstack-doc03:31
openstackgerritMerged openstack/openstackdocstheme master: Remove navigation.html  https://review.openstack.org/49042503:34
*** edmondsw has quit IRC03:34
*** suyog has quit IRC03:38
*** khushbu has quit IRC03:44
*** ekcs has quit IRC03:44
*** yangyapeng has quit IRC03:51
*** mriedem has quit IRC03:53
*** suyog has joined #openstack-doc03:54
*** yangyapeng has joined #openstack-doc03:58
*** skelso has quit IRC03:59
*** yangyapeng has quit IRC04:03
*** yangyapeng has joined #openstack-doc04:07
*** yangyapeng has quit IRC04:12
*** suyog has quit IRC04:14
*** yangyapeng has joined #openstack-doc04:16
*** thorst_afk has joined #openstack-doc04:19
*** yangyapeng has quit IRC04:21
*** yangyapeng has joined #openstack-doc04:22
*** khushbu_ has joined #openstack-doc04:23
*** khushbu_ has joined #openstack-doc04:24
*** yangyapeng has quit IRC04:27
*** edmondsw has joined #openstack-doc04:31
*** yangyapeng has joined #openstack-doc04:31
*** thorst_afk has quit IRC04:33
*** yangyapeng has quit IRC04:35
*** edmondsw has quit IRC04:36
*** yangyapeng has joined #openstack-doc04:40
*** yangyapeng has quit IRC04:41
*** yangyapeng has joined #openstack-doc04:41
*** bsilverman_ has quit IRC04:51
*** masaki has quit IRC05:11
*** masaki has joined #openstack-doc05:12
*** phuongnh has quit IRC05:18
*** phuongnh has joined #openstack-doc05:19
*** gouthamr has quit IRC05:31
*** larainema has quit IRC05:32
*** thorst_afk has joined #openstack-doc06:01
*** thorst_afk has quit IRC06:05
*** edmondsw has joined #openstack-doc06:19
*** edmondsw has quit IRC06:24
*** rcernin has joined #openstack-doc06:30
*** dmacpher has quit IRC06:35
*** jpena|off is now known as jpena06:52
openstackgerritOpenStack Proposal Bot proposed openstack/openstack-manuals master: Imported Translations from Zanata  https://review.openstack.org/49076406:57
openstackgerritOpenStack Proposal Bot proposed openstack/openstack-manuals stable/newton: Imported Translations from Zanata  https://review.openstack.org/49076607:06
*** ekcs has joined #openstack-doc07:06
*** ekcs has quit IRC07:10
*** alexchadin has joined #openstack-doc07:10
openstackgerritOpenStack Proposal Bot proposed openstack/openstack-manuals stable/ocata: Imported Translations from Zanata  https://review.openstack.org/49076907:13
*** tesseract has joined #openstack-doc07:16
*** khushbu_ has quit IRC07:23
*** phuongnh has quit IRC07:29
*** phuongnh has joined #openstack-doc07:29
*** jpena is now known as jpena|brb07:30
openstackgerrityanghuichan proposed openstack/api-site master: Replace dict.itervalues() with dict.values()  https://review.openstack.org/49077707:31
openstackgerritOpenStack Proposal Bot proposed openstack/training-guides master: Imported Translations from Zanata  https://review.openstack.org/49077907:35
*** pcaruana has joined #openstack-doc07:38
*** http_GK1wmSU has joined #openstack-doc07:49
*** http_GK1wmSU has left #openstack-doc07:52
openstackgerritMerged openstack/openstack-manuals stable/ocata: Imported Translations from Zanata  https://review.openstack.org/49076907:52
openstackgerritMerged openstack/training-guides master: Imported Translations from Zanata  https://review.openstack.org/49077907:52
openstackgerritMerged openstack/openstack-manuals stable/newton: Imported Translations from Zanata  https://review.openstack.org/49076607:55
openstackgerritMerged openstack/openstack-manuals master: Imported Translations from Zanata  https://review.openstack.org/49076407:55
*** jpena|brb is now known as jpena07:55
*** thorst_afk has joined #openstack-doc08:02
*** khushbu has joined #openstack-doc08:02
*** khushbu has quit IRC08:03
*** khushbu has joined #openstack-doc08:04
*** thorst_afk has quit IRC08:06
asettleGood morning :)08:06
asettlestephenfin: you good to merge this one? https://review.openstack.org/#/c/477488/08:07
* asettle starts early08:07
*** belmoreira has joined #openstack-doc08:10
*** phuongnh has quit IRC08:11
AJaegergood morning, asettle08:15
stephenfinasettle: Yeah, I think that one's all good to go08:18
stephenfinThough wasn't there some conditional steps in the installation guide? Were they removed?08:19
* stephenfin only rebased it and hasn't reviewed it yet. Will do so now08:19
asettlestephenfin: we removed all those shenanigans before giving it over to you08:20
asettleBecause we're nice.08:20
AJaegerstephenfin: we remove the conditions and just folded five guides into one - so that you have a combined one.08:20
AJaegerFar easier to build...08:20
AJaegerand yes, asettle is nice ;)08:21
AJaegeras is dhellmann :)08:21
asettleAnd so is AJaeger08:21
asettleAwww <308:21
asettleNice team08:21
asettleAlthough watch out for that Anne lady... she's tricky08:21
asettle:p08:21
stephenfinYou guys are weird08:22
stephenfin;)08:22
stephenfinasettle: Just me, or is all the indentation messed up in this? https://review.openstack.org/#/c/477488/8/doc/source/install/compute-install-obs.rst08:23
asettlestephenfin: ah no, you're weird08:23
asettleLemme look08:23
asettlestephenfin: yeah there's a few things there that are not quite inline. Also, tonnes of whitespace08:23
stephenfinasettle: I know you are but what am I?08:24
* stephenfin straightens up and puts on adult face08:24
stephenfinOK, cool. I'll go through and fix those quickly so08:24
asettle(y)08:24
asettleNeat08:24
asettleThanks08:24
*** nicolasbock has joined #openstack-doc08:25
AJaeger;)08:29
*** efoley has joined #openstack-doc08:30
*** yamamoto has quit IRC08:37
*** yamamoto has joined #openstack-doc08:50
*** khushbu has quit IRC08:51
*** khushbu_ has joined #openstack-doc08:52
*** khushbu_ has quit IRC08:54
*** khushbu has joined #openstack-doc08:54
openstackgerritMerged openstack/openstack-manuals master: Update the usage of openstack-doc-tools  https://review.openstack.org/49072508:56
*** masaki has quit IRC09:02
*** thorst_afk has joined #openstack-doc09:03
*** khushbu has quit IRC09:03
*** khushbu_ has joined #openstack-doc09:04
*** khushbu_ has quit IRC09:06
*** khushbu has joined #openstack-doc09:06
*** thorst_afk has quit IRC09:07
*** khushbu has quit IRC09:08
*** s-shiono has quit IRC09:14
*** khushbu has joined #openstack-doc09:20
*** khushbu has quit IRC09:22
*** khushbu has joined #openstack-doc09:22
*** khushbu has quit IRC09:24
*** tosky has joined #openstack-doc09:25
*** khushbu has joined #openstack-doc09:28
*** mikal has quit IRC09:39
*** mikal has joined #openstack-doc09:41
*** sdague has joined #openstack-doc09:42
*** tosky has quit IRC09:44
*** sambetts|afk is now known as sambetts09:46
*** khushbu has quit IRC09:47
*** khushbu has joined #openstack-doc09:55
*** edmondsw has joined #openstack-doc09:55
*** khushbu has quit IRC09:58
*** edmondsw has quit IRC10:00
*** khushbu has joined #openstack-doc10:03
*** khushbu has quit IRC10:06
*** openstackgerrit has quit IRC10:18
*** yamamoto has quit IRC10:32
*** yamamoto has joined #openstack-doc10:33
*** edmondsw has joined #openstack-doc10:36
*** yamamoto has quit IRC10:38
*** edmondsw has quit IRC10:40
*** yamamoto has joined #openstack-doc10:48
asettleAJaeger dhellmann - sdague was asking: "do you know if the toc warning is ignorable from sphinx so we don't keep having to use hidden tocs?"10:59
asettleI haven't tried before11:00
*** tosky has joined #openstack-doc11:02
*** thorst_afk has joined #openstack-doc11:04
*** pkovar has joined #openstack-doc11:08
*** thorst_afk has quit IRC11:08
*** khushbu_ has joined #openstack-doc11:30
*** yangyapeng has quit IRC11:30
*** JoseMello has joined #openstack-doc11:30
AJaegeryou can use ..orphan:: to ignore specific pages11:30
AJaegerOr add them to the exclude list, let me find a link for you11:31
AJaegerasettle: http://git.openstack.org/cgit/openstack/openstack-manuals/tree/doc/admin-guide/source/conf.py#n8011:31
*** yamamoto has quit IRC11:39
*** http_GK1wmSU has joined #openstack-doc11:45
*** http_GK1wmSU has left #openstack-doc11:47
*** edmondsw has joined #openstack-doc11:47
sdagueAJaeger: right, I was wondering if we can just fully ignore the warning11:49
sdagueAJaeger: we're not trying to ignore the files11:49
sdagueI'm trying to get out of the sphinx shackles that everything has to be in the TOC11:49
sdaguebecause, while that's a fine restriction for print11:49
sdagueit's a sucky one for web where you may come in via different facets11:50
sdagueit's not one linear flow11:50
AJaegersdague: I think orphan might work in that case11:50
AJaegersdague: I'm not aware of a global flag to set11:51
*** thorst_afk has joined #openstack-doc11:51
*** thorst_afk has quit IRC11:52
AJaegersdague: there's suppress_warnings flag but it does not handle this warning11:52
*** edmondsw has quit IRC11:52
AJaegerWait, what about app.add_node ? Have a look whether any of these work: http://sphinx.readthedocs.io/en/stable/config.html#general-configuration11:53
*** jpena is now known as jpena|lunch11:54
sdagueAJaeger: yeh, that was the question about whether there was a warning I could catch11:55
AJaegersdague: looking at source code in environment/__init__.py - there's only orphan to disable this for specific files - for your entry points11:56
sdagueso just .. orphan:: at the top of pages?11:57
AJaegeryes11:58
sdagueok, good to know11:59
AJaegersdague: http://git.openstack.org/cgit/openstack/openstack-manuals/tree/doc/admin-guide/source/support-compute.rst#n211:59
sdagueok12:00
*** thorst has joined #openstack-doc12:06
dhellmannasettle, AJaeger, stephenfin : o/12:14
asettleMorn! o/12:14
AJaegermorning, dhellmann12:14
dhellmannAJaeger, sdague : you can use suppress_warnings to ignore some warnings, but I don't recommend ignoring that one12:15
dhellmannthe toctree is how sphinx knows how your files tie together, so if you start messing with it you may end up with a site where it's only possible to navigate to pages if you know the url12:15
*** skelso has joined #openstack-doc12:17
*** larainema has joined #openstack-doc12:20
*** edmondsw has joined #openstack-doc12:23
sdaguedhellmann: not if you have deep links. The nova manual at this point is enormous, and at least with the openstackdocs theme in the way it does the toc display it's kind of a mess12:25
sdagueasettle: so is https://docs.openstack.org/nova/latest/install/controller-install.html because we're missing something on the distro selection front?12:25
dhellmannif you remove a page from the toctree, and do not have a link to it, and disable the warning, you end up with an orphaned page. It may not be the end of the world, and if you want to keep up with making sure you actually link to all files, that's fine. I'm just explaining why I think it's a bad idea.12:26
dhellmannthe theme is a wip, like everything else, so if you have issues with it either file a bug or a patch12:26
asettlesdague: looks like we'll need to jump in and rename each section appropriately. I missed that, sorry. The file names are correct, so I can propose a patch to fix that12:26
sdagueasettle: right, but I wouldn't expect the next navigation to be install debian -> install ubuntu -> install fedora12:27
sdaguewhich is what it is now12:27
asettleLet me take a look :) i'll propose a patch to fix that12:28
sdagueon the install / admin side, how free are we at changing some of those titles, because if we make them fit more with the nova manual, they'll fit less with trying to build an overall install manual for openstack12:29
sdagueor, I guess, more specifically, what is the plan for that?12:29
asettleSo, I'll separate into the three packages, and then have compute install, controll install within12:29
sdagueasettle: ok, cool12:29
asettlesdague: they're your docs now :) go for it. I mean, it would be good for this release to have some synergy across. But it's up to you guys to determine what's best for your users12:29
asettleHappy to guide12:29
sdagueasettle: ok, so there is not going to be a consolidated manual anywhere?12:30
dhellmannno, that's the whole point of this, we can't sustain that12:30
asettleAs dhellmann said :)12:30
sdagueok, I thought we were taking the subject content back in, but still creating the collective build out of the parts12:31
dhellmannno12:31
dhellmannthere is a landing page that links to all of the individual project guides, that's it12:31
sdagueok12:31
asettleTL;DR - all yours!12:32
asettle:)12:32
*** khushbu_ has quit IRC12:32
toskyI'm (finally) restructuring the Sahara documentation, but I'm not sure about what to put exactly in the admin guide vs user or configuration12:35
toskyalso, should configuration only contain the autogenerated content, and move the advanced description of configuration to admin/ ?12:35
asettletosky: as per the spec, 'user' refers to end user. Admin should be targeted towards your operators12:37
asettleIf the advanced description is not configuration content, then include in admin12:37
asettleBut the auto-gen should definitely be in config12:37
toskyfor example, let's see those 3 pages12:38
toskyhttps://docs.openstack.org/sahara/latest/userdoc/configuration.guide.html12:38
toskyhttps://docs.openstack.org/sahara/latest/userdoc/advanced.configuration.guide.html12:38
toskyhttps://docs.openstack.org/sahara/latest/userdoc/upgrade.guide.html12:38
asettlesdague: so I'll push up a patch shortly. But I've made is so it's clearly marked as three different installs, and i'll add a note about using the particular instructions PER package12:38
toskymore admin?12:38
asettleAt a cursory glance, yep tosky :(12:38
asettle:) *12:38
asettleNo sad face, happy face12:38
asettleLove me some config12:38
toskyo.O12:38
toskyI was confused by the sad face12:38
*** yamamoto has joined #openstack-doc12:40
asettlesdague: real small fix: https://review.openstack.org/#/c/490844/12:42
asettleIt should ease confusion until we do proper restructure :)12:42
asettlestephenfin: ^12:42
toskyand each major subsection (user/, contributor/, references/, admin/, etc) should have its own index.rst, because they can be used independently from the each other, right?12:44
*** yamamoto has quit IRC12:45
stephenfinasettle: done12:45
asettlewow that's mean12:45
asettleDone12:45
*** rbowen has joined #openstack-doc12:46
dhellmanntosky : yes, that's right. And because the series landing pages on docs.o.o will link to those index pages12:46
dhellmanntosky : if it helps, the intent for the /configuration directory was to only have auto-generated configuration reference content12:46
toskydhellmann: that helps, thanks12:48
pkovartosky: also, e.g. https://docs.openstack.org/sahara/latest/userdoc/ now shows a directory listing which is not very nice. you want to avoid that12:48
toskybut you will see the review, hopefully in few minutes12:48
toskylet's say one hour12:48
stephenfinasettle: Sometimes you've got to be cruel to be kind12:49
*** yangyapeng has joined #openstack-doc12:49
asettleSureeee12:52
*** yangyapeng has quit IRC12:53
*** jpena|lunch is now known as jpena12:55
*** yangyapeng has joined #openstack-doc13:16
*** catintheroof has joined #openstack-doc13:17
asettleOkay dhellmann stephenfin and sdague - i'm out early to head to the aeroporto! If you guys need anything or reviews - add me as a reviewer and I'll look Monday morn :)13:28
asettleHope everyone has a good weekend!13:28
stephenfinasettle: Enjoy :)13:29
asettleTHanks pal o/13:29
dhellmannasettle : safe travels!13:29
asettleo/13:29
AJaegerasettle: safe travels!13:31
*** lucasxu has joined #openstack-doc13:34
*** Dinesh_Bhor has quit IRC13:47
toskyoh, Sahara should be fine (at least until you start reviewing it :) https://review.openstack.org/49087213:49
*** mriedem has joined #openstack-doc13:50
*** shaunm has quit IRC14:00
*** khushbu has joined #openstack-doc14:03
*** alexchadin has quit IRC14:04
*** donghao has joined #openstack-doc14:07
*** khushbu has quit IRC14:08
*** skelso has quit IRC14:08
*** skelso has joined #openstack-doc14:10
*** nicolasbock has quit IRC14:39
*** skelso has quit IRC14:45
*** gouthamr has joined #openstack-doc14:45
*** skelso has joined #openstack-doc14:45
*** emagana has joined #openstack-doc15:08
toskydo we need to restructure also the documentation of a non-service like the sahara-tests repository? https://docs.openstack.org/sahara-tests/latest/15:13
*** rcernin has quit IRC15:14
AJaegertosky: only if you want to link to special pages in it15:14
AJaegermeaning: We have index pages to link to your user/admin/etc guides - if you have none, no need to do anything15:14
toskyack, then it's fine I guess15:15
toskyat least for now15:15
*** lucasxu has quit IRC15:15
toskyby the way, is the preview of the changes though docs-stage in jobs a "recent" improvement?15:17
toskyor did I simply not noticed it until one month ago?15:17
toskypkovar: hi! So, filename, I'm going to change to '-'; it's fine for development.guidelines -> development-guidelines, but also how_to_participate should be how-to-partecipate?15:23
toskywell, probably yes15:24
pkovartosky: hey15:26
pkovartosky: yeah, as you said, just changing to dashes everywhere would be best15:26
pkovari mean, you are renaming the files anyway15:27
AJaegertosky: the docs job preview is there since before I joined - so ages ok ;)15:27
tosky:/ never noticed, silly me15:27
toskypkovar: the renaming of the file is easy, the interlinks are more complicated, but I will manage before the end of the day :)15:27
pkovartosky: thank you!15:28
toskypkovar: apart from that, does the new structure make sense, at least from a first glance from a non-contributor/non-user of Sahara?15:29
AJaegertosky: you might not be the only one - talk loudly about the hidden gem you just found, please ;)15:29
pkovartosky: the structure does look good, also i just realized sahara was probably never part of the common install guide15:32
toskyyep, most likely15:33
pkovarcoz your install docs are different15:33
dhellmanntosky : keep in mind that every file you rename breaks a bookmark or stackoverflow reference to that page15:37
toskydhellmann: that's correct15:37
pkovaryeah, thats the price you have to pay for consistency or better structure15:38
pkovarunless you can set up redirects15:38
toskydhellmann: but then also https://docs.openstack.org/sahara/latest/userdoc/hadoop-swift.html will be broken because userdoc won't exist anymore15:38
pkovargood point15:39
dhellmanntosky : http://lists.openstack.org/pipermail/openstack-dev/2017-August/120418.html explains how to set up redirects15:39
dhellmannif you've moving the file, renaming it at the same time makes sense, but if you're not touching it otherwise I wouldn't rename it15:39
toskyuhm, I can invest some time in the redirects, but after the release for Queens (ensuring that the latest/ link will still work)15:41
*** openstackgerrit has joined #openstack-doc15:41
openstackgerritMerged openstack/api-site master: Replace dict.itervalues() with dict.values()  https://review.openstack.org/49077715:41
dhellmanntosky : ++15:41
toskybut yeah, I'm halfway through the renames; as you said, this is the best time for renaming also the file (in addition to the path)15:44
*** belmoreira has quit IRC15:44
*** lucasxu has joined #openstack-doc15:59
tosky... and uploaded16:07
*** pcaruana has quit IRC16:10
*** mriedem is now known as mriedem_lunch16:18
*** donghao has quit IRC16:28
*** donghao has joined #openstack-doc16:47
*** efoley has quit IRC16:54
*** sambetts is now known as sambetts|afk17:11
*** jpena is now known as jpena|off17:14
*** donghao has quit IRC17:14
openstackgerritSean Dague proposed openstack/openstackdocstheme master: Tweak css for sidebar  https://review.openstack.org/49099117:17
*** edmondsw_ has joined #openstack-doc17:23
*** edmondsw has quit IRC17:26
*** tosky has quit IRC17:27
*** openstackstatus has quit IRC17:27
*** openstack has joined #openstack-doc17:29
*** emagana has quit IRC18:03
*** emagana has joined #openstack-doc18:04
*** pkovar has quit IRC18:07
*** ekcs has joined #openstack-doc18:17
*** mriedem has joined #openstack-doc18:17
*** mriedem_lunch has quit IRC18:18
*** sambetts|afk has quit IRC18:19
*** sambetts_ has joined #openstack-doc18:21
*** openstackstatus has quit IRC18:26
*** openstack has joined #openstack-doc18:29
*** reed has quit IRC18:39
*** reed has joined #openstack-doc18:40
*** thorst has quit IRC19:03
*** thorst has joined #openstack-doc19:06
*** sambetts_ has quit IRC19:06
*** sambetts_ has joined #openstack-doc19:08
*** thorst has quit IRC19:10
*** thorst has joined #openstack-doc19:18
*** thorst has quit IRC19:20
*** thorst has joined #openstack-doc19:20
-openstackstatus- NOTICE: Gerrit is being restarted to pick up CSS changes and should be back momentarily20:35
*** skelso has quit IRC20:45
*** skelso has joined #openstack-doc20:45
*** lucasxu has quit IRC20:51
*** emagana has quit IRC20:53
*** emagana has joined #openstack-doc20:54
*** emagana has quit IRC20:59
*** sambetts_ has quit IRC21:02
*** rbowen has quit IRC21:02
*** sambetts_ has joined #openstack-doc21:06
*** sdague has quit IRC21:08
*** emagana has joined #openstack-doc21:14
*** thorst has quit IRC21:21
*** thorst has joined #openstack-doc21:22
*** thorst has quit IRC21:26
*** skelso has quit IRC21:30
*** edmondsw_ has quit IRC21:47
*** gouthamr has quit IRC21:47
*** yamamoto has joined #openstack-doc22:00
*** JoseMello has quit IRC22:06
*** thorst has joined #openstack-doc22:22
*** emagana has quit IRC22:23
*** emagana has joined #openstack-doc22:24
*** thorst has quit IRC22:28
*** emagana has quit IRC22:29
*** yamamoto has quit IRC22:41
*** emagana has joined #openstack-doc22:43
*** emagana has quit IRC22:43
*** emagana has joined #openstack-doc22:44
*** emagana has quit IRC22:47
*** catintheroof has quit IRC22:56
*** yamamoto has joined #openstack-doc23:09
*** gouthamr has joined #openstack-doc23:32
*** edmondsw has joined #openstack-doc23:36
*** edmondsw has quit IRC23:40

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