Wednesday, 2017-07-26

*** masaki has joined #openstack-doc00:02
*** yamamoto has quit IRC00:10
*** yamamoto has joined #openstack-doc00:11
*** gmann has quit IRC00:15
*** gmann has joined #openstack-doc00:15
*** edmondsw has joined #openstack-doc00:20
*** fragatina has quit IRC00:23
*** edmondsw has quit IRC00:25
*** skelso has joined #openstack-doc00:28
*** thorst has joined #openstack-doc00:29
*** thorst has quit IRC00:33
*** thorst has joined #openstack-doc00:59
*** s-shiono has joined #openstack-doc01:01
*** phuongnh has joined #openstack-doc01:02
*** thorst has quit IRC01:07
*** dmacpher has joined #openstack-doc01:16
*** lucasxu has joined #openstack-doc01:22
*** lucasxu has quit IRC01:24
*** mriedem has quit IRC01:29
*** masaki has quit IRC01:45
*** masaki has joined #openstack-doc01:49
*** mihalis68 has joined #openstack-doc01:51
*** edmondsw has joined #openstack-doc02:08
*** masaki has quit IRC02:11
*** masaki has joined #openstack-doc02:11
*** edmondsw has quit IRC02:13
*** gaurangt has quit IRC02:22
*** gaurangt has joined #openstack-doc02:25
*** gouthamr has joined #openstack-doc02:31
*** skelso has quit IRC02:32
*** edmondsw has joined #openstack-doc03:57
*** fragatina has joined #openstack-doc03:57
*** fragatina has quit IRC04:00
*** fragatina has joined #openstack-doc04:01
*** edmondsw has quit IRC04:01
*** mihalis68 has quit IRC04:01
*** nicolasbock has joined #openstack-doc04:04
*** deep-book-gk_ has joined #openstack-doc04:32
*** deep-book-gk_ has left #openstack-doc04:33
*** suyog has quit IRC04:46
*** vharsh has joined #openstack-doc04:56
*** charcol has quit IRC04:58
*** gouthamr has quit IRC05:00
*** suyog has joined #openstack-doc05:03
*** thorst has joined #openstack-doc05:04
*** thorst has quit IRC05:10
*** masaki has quit IRC05:20
*** masaki has joined #openstack-doc05:21
*** edmondsw has joined #openstack-doc05:45
*** edmondsw has quit IRC05:49
*** dmacpher has quit IRC05:56
*** fragatina has quit IRC06:03
*** fragatina has joined #openstack-doc06:05
*** rcernin has joined #openstack-doc06:06
*** fragatina has quit IRC06:08
*** andreas_s has joined #openstack-doc06:09
*** dmacpher has joined #openstack-doc06:13
*** thorst has joined #openstack-doc06:29
openstackgerritChason Chan proposed openstack/openstack-doc-tools master: Make openstack-doc-tools can be used in the individual client repos  https://review.openstack.org/48729206:30
*** thorst has quit IRC06:33
AJaegerdhellmann: wow, great automation!06:36
*** suyog has quit IRC06:46
*** yamamoto has quit IRC06:54
*** belmoreira has joined #openstack-doc07:05
*** dmacpher has quit IRC07:17
*** edmondsw has joined #openstack-doc07:33
*** edmondsw has quit IRC07:37
*** masaki has quit IRC07:39
*** alexchadin has joined #openstack-doc07:43
*** yamamoto has joined #openstack-doc07:55
*** yamamoto has quit IRC08:02
*** s-shiono has quit IRC08:23
*** efoley has joined #openstack-doc08:23
*** efoley_ has joined #openstack-doc08:24
*** efoley has quit IRC08:24
*** thorst has joined #openstack-doc08:30
*** thorst has quit IRC08:34
*** efoley_ is now known as efoley08:35
*** stevemar has quit IRC08:36
*** stevemar has joined #openstack-doc08:36
asettleMorning o/08:45
*** katyafervent_awa has quit IRC09:20
*** katyafervent_awa has joined #openstack-doc09:20
*** stephenfin has quit IRC09:21
*** KeithMnemonic2 has joined #openstack-doc09:22
*** suyog has joined #openstack-doc09:22
*** suyog has quit IRC09:22
*** edmondsw has joined #openstack-doc09:22
*** KeithMnemonic1 has quit IRC09:22
AJaegermorning, asettle !09:23
*** odyssey4me has quit IRC09:23
*** stephenfin has joined #openstack-doc09:24
*** yamamoto has joined #openstack-doc09:24
*** edmondsw has quit IRC09:25
*** odyssey4me has joined #openstack-doc09:27
*** yamamoto has quit IRC09:35
openstackgerritMerged openstack/openstack-manuals master: the mistral team deleted their admin guide landing page  https://review.openstack.org/48720909:38
openstackgerritMerged openstack/openstack-manuals master: add landing pages for historical versions  https://review.openstack.org/48719709:38
openstackgerritMerged openstack/openstackdocstheme master: move the localtoc for the page into the sidebar  https://review.openstack.org/48710309:39
openstackgerritMerged openstack/openstackdocstheme master: Serve minified CSS  https://review.openstack.org/48695609:40
*** sambetts|afk is now known as sambetts09:40
*** yamamoto has joined #openstack-doc09:45
openstackgerritMerged openstack/openstack-manuals master: update release dates and status on all landing pages  https://review.openstack.org/48719809:45
openstackgerritMerged openstack/openstack-manuals master: move series dates into generator  https://review.openstack.org/48719909:45
openstackgerritMerged openstack/openstack-manuals master: use SERIES_INFO to pick up the message to describe the series status  https://review.openstack.org/48720009:45
openstackgerritMerged openstack/openstack-manuals master: move repetitive content from the index pages to the indexbase template  https://review.openstack.org/48720109:45
openstackgerritMerged openstack/openstack-manuals master: link to keystone admin and config guides  https://review.openstack.org/48702609:45
*** alexchadin has quit IRC09:46
*** thorst has joined #openstack-doc09:58
openstackgerritSharat Sharma proposed openstack/openstack-manuals master: Revert "the mistral team deleted their admin guide landing page"  https://review.openstack.org/48735210:00
*** thorst has quit IRC10:06
*** thorst has joined #openstack-doc10:07
*** thorst has quit IRC10:11
*** phuongnh has quit IRC10:20
openstackgerritSharat Sharma proposed openstack/openstack-manuals master: Revert "the mistral team deleted their admin guide landing page"  https://review.openstack.org/48735210:21
AJaegerasettle: a docs-specs change for review https://review.openstack.org/487204 (low prio)10:34
AJaegerasettle, dhellmann : and one for openstack-doc-tools, please: https://review.openstack.org/48715110:34
asettleOH thanks, I missed that one10:35
openstackgerritMerged openstack/docs-specs master: switch to openstackdocstheme  https://review.openstack.org/48720410:39
*** edmondsw has joined #openstack-doc11:09
asettlebrb :)11:10
*** edmondsw has quit IRC11:13
openstackgerritRob Cresswell proposed openstack/openstackdocstheme master: Fix a logic issue in the JS  https://review.openstack.org/48737811:44
robcresswellasettle, AJaeger: ^^ That fixes a logic issue I introduced11:44
robcresswell*hangs head in shame*11:44
robcresswellRushed a patch and didn't properly consider my jquery :)11:45
*** vharsh has quit IRC11:47
AJaegerrobcresswell: for the change that merged today - or do we need a new release?11:50
robcresswellIts for a change that has been released unfortunately. If you look at https://docs.openstack.org/horizon/latest/configuration/settings.html#default-theme for example, you'll see all the icons are missing from versionadded etc.11:51
robcresswellI didnt catch it on the demo page, because that only does one of each.11:51
robcresswellSo yeah, made a dum on my selector logic. My fault, shouldn't have rushed it.11:52
robcresswellAnyway, thats the fix :)11:52
AJaegerrobcresswell: can you update the demo page, please?11:52
AJaegerI'm busy the rest of the day, hope others can review and help with a release.11:52
setuidFor those that received it, did the email I just sent to -docs clarify what we discussed yesterday?11:52
AJaegerThanks a lot for catching and releasing11:53
AJaegerbbl11:53
robcresswellSure11:53
openstackgerritRob Cresswell proposed openstack/openstackdocstheme master: Fix a logic issue in the JS  https://review.openstack.org/48737811:55
*** yamamoto has quit IRC11:57
*** vharsh has joined #openstack-doc12:00
*** Dinesh_Bhor is now known as Dinesh_Bhor|away12:08
*** Dinesh_Bhor|away is now known as Dinesh_Bhor12:09
*** yamamoto has joined #openstack-doc12:13
*** edmondsw has joined #openstack-doc12:13
*** thorst has joined #openstack-doc12:16
*** chlong has joined #openstack-doc12:16
dhellmannAJaeger, asettle : o/12:18
robcresswelldhellmann: If you read the scrollback a few lines, there's a small bugfix there ^^12:18
dhellmannlooking12:19
robcresswellif you have time ofc. It's relatively minor.12:19
dhellmann+2 from me12:20
dhellmannshould we go ahead and hold any new theme release to wait for this?12:21
*** catintheroof has joined #openstack-doc12:21
robcresswelldhellmann: I think so, yes12:22
*** vharsh has quit IRC12:22
dhellmannok, noted12:22
robcresswellI'll fill out that demo page a little more as well, so any issues are more apparent.12:22
robcresswellIn a separate patch, that is.12:22
openstackgerritMerged openstack/openstackdocstheme master: Fix a logic issue in the JS  https://review.openstack.org/48737812:24
AJaegerdhellmann: +2A, so merged ^12:25
AJaegerdhellmann, asettle : Anybody wants to do a new release -or should we wait?12:25
dhellmannrobcresswell : that would be good, thanks12:25
dhellmannAJaeger : let's do it today so we can branch12:25
* dhellmann check that we do branch the theme12:25
dhellmannoh, I guess not12:26
*** mriedem has joined #openstack-doc12:39
*** mriedem has left #openstack-doc12:40
*** mriedem has joined #openstack-doc12:40
*** efoley has quit IRC12:47
asettledhellmann: what happend?12:50
asettleWHat'd we do?12:50
*** efoley has joined #openstack-doc12:50
*** egallen has joined #openstack-doc12:53
asettleNice summary setuid :D12:53
asettleThanks pal12:53
*** yamamoto has quit IRC12:54
*** tylerderosagrund has joined #openstack-doc12:55
dhellmannasettle : robcresswell fixed a bug in the theme, I was suggesting we wait to release after that has merged12:55
asettleNeat :)12:56
*** dustins has joined #openstack-doc13:01
*** tylerderosagrund has quit IRC13:04
AJaeger https://review.openstack.org/487409 is the openstackdocstheme 1.16 release13:06
AJaegerdhellmann: we'Re not branching so far...13:06
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: add links to docs for more pike projects  https://review.openstack.org/48741113:06
dhellmannAJaeger : yeah, that makes sense13:06
dhellmannI'll watch for the jobs to finish on that release patch and then review it13:07
*** yamamoto has joined #openstack-doc13:09
*** tylerderosagrund has joined #openstack-doc13:12
tylerderosagrundGood morning all13:13
*** dustins has quit IRC13:18
AJaegerrobcresswell, dhellmann, asettle openstackdocstheme 1.16 is released - now update for upper-constraints.txt is the one thing we need before it'S used everywhere13:23
asettleOkay :)13:26
*** catintheroof has quit IRC13:44
*** yuval has joined #openstack-doc13:45
setuidasettle: Did I miss anything important? I guess we could peel back the layers in the coming days on the ML13:46
*** catintheroof has joined #openstack-doc13:46
asettlesetuid: I don't think so :)13:46
yuvalHey :) We've just uploaded Karbor's in-tree install/ and config/ guides, but they do not appear in docs.openstack.org , any idea why? Takes time to build? (we have openstack-unified-publish-jobs gate)13:48
*** catintheroof has quit IRC13:48
*** catintheroof has joined #openstack-doc13:48
AJaegeryuval: check status.openstack.org/zuul13:51
*** catintheroof has quit IRC13:51
AJaegerPUblishing is done as part of a post job, and then needs 5 mins to sync.13:51
AJaegerSo, has your job run?13:51
AJaegeryuval: read also https://docs.openstack.org/contributor-guide/landing-pages.html to link to it13:52
*** catintheroof has joined #openstack-doc13:52
*** rcernin has quit IRC13:54
yuvalAJaeger: probably that13:54
yuvalAJaeger: thanks!13:54
*** donghao has joined #openstack-doc13:58
*** dustins has joined #openstack-doc14:06
*** xiaofandh12 has joined #openstack-doc14:08
*** donghao has quit IRC14:08
*** dustins has quit IRC14:09
*** dustins has joined #openstack-doc14:09
openstackgerritYuval Brik proposed openstack/openstack-manuals master: Karbor: has admin, install, config guides  https://review.openstack.org/48743914:09
*** gouthamr has joined #openstack-doc14:12
*** dustins has quit IRC14:19
*** dustins has joined #openstack-doc14:20
*** dustins has quit IRC14:21
AJaegeryuval: recheck your change once the content is published, we check that it exists ^14:21
*** dustins has joined #openstack-doc14:21
*** dustins has quit IRC14:21
*** dustins has joined #openstack-doc14:22
*** dustins has quit IRC14:22
*** dustins has joined #openstack-doc14:23
*** yamamoto has quit IRC14:24
*** dustins has quit IRC14:35
*** dustins has joined #openstack-doc14:36
*** dustins has quit IRC14:37
yuvalAJaeger: will do, thanks :)14:38
dhellmannsetuid : which list did your message go to? I haven't seen it yet, and I want to make sure I'm on all the lists14:41
asettledhellmann: docs yo :)14:58
asettlesetuid: yo bro you makin' me read so muchhhh15:08
*** dustins has joined #openstack-doc15:12
dhellmannasettle : I thought I signed up for that one. How many lists does this team have!? :-)15:19
setuidasettle: Sorry! I prefer to be verbose, clarify the bits15:19
asettledhellmann: thankfully just one. Would you like me to forward? Fairly sure you did sign up!15:20
asettlesetuid: I'm just joshing mannnnn :D15:20
dhellmannasettle : yeah, please, that way I can check my mail filters to see what happened to the original15:20
asettleYou got it :)15:20
*** rcernin has joined #openstack-doc15:21
* dhellmann tips his hat to asettle 15:22
asettlehttp://i.imgur.com/Zw468as.png15:24
*** yamamoto has joined #openstack-doc15:24
AJaegerdhellmann: could you review https://review.openstack.org/487151 , please? This is for our tool generating the sitemap15:25
dhellmannAJaeger : do you want to go ahead and add pike?15:25
dhellmann+2a on that one in the mean time15:26
AJaegerdhellmann: no, pike is current - we only add *old* releases...15:28
dhellmannah15:28
AJaegerAnd yes, this could use some refinement with old and really old releases.15:28
AJaegersetuid: something you might be interested in as well, see 48715115:28
*** belmoreira has quit IRC15:29
dhellmannoh, ffs, why is mail delivery disabled for me on that list15:31
dhellmannAJaeger : I think before we put a lot of effort into that tool, we should talk about revamping the sitemap generation to happen every time docs are published15:31
setuidAJaeger: I'll add that to my build bootstrap and see what (if anything) needs to be done to build it15:31
openstackgerritMerged openstack/openstack-doc-tools master: sitemap: Add ocata  https://review.openstack.org/48715115:33
*** rcernin has quit IRC15:34
* dhellmann imports 600+ messages from the docs ML archives so he can catch up15:34
*** andreas_s has quit IRC15:35
*** yamamoto has quit IRC15:36
AJaegerdhellmann: yeah, there are various options open. Just wanted to point out current basic approach15:44
asettledhellmann: why weren't those emails going through to you? I was certain you were subscribed15:51
dhellmannasettle: I was susbscribed but had apparently set the flag to disable mail delivery at some point in the past15:52
dhellmannI'm reading the last 3 months archives as penance15:52
asettledhellmann: oh I see how it is15:52
asettleEh, there's nothing exciting :P15:52
dhellmannI may have to grab the archives again tomorrow after the thread I was actually trying to follow is added to the zip file15:55
dhellmannasettle : now that most of the docs content is actually going to be in project repos, I wonder if it's time to merge the docs ML into the dev ML. Or at least have the "strategic direction" discussion over there, where the rest of the contributors will be see it15:59
*** imacdonn_ has quit IRC15:59
*** imacdonn_ has joined #openstack-doc15:59
dhellmannI know that means asking docs team members to deal with an extremely busy mailing list15:59
asettleProbably right about time to switch over - maybe it's worth starting the convo, and ensuring it is achieved for the start of Queens16:00
asettleWould make sense16:00
dhellmannshould I propose that?16:00
dhellmannI suppose *that* conversation should happen on the docs list16:01
*** rcernin has joined #openstack-doc16:03
*** chlong has quit IRC16:08
dhellmanndone16:09
*** xiaofandh12 has quit IRC16:10
AJaegerasettle: want to +2a https://review.openstack.org/487411 ?16:48
asettledhellmann: yeah probably :)16:51
asettleAJaeger: on it16:51
openstackgerritMerged openstack/openstack-manuals master: add links to docs for more pike projects  https://review.openstack.org/48741116:57
AJaegerthanks, asettle16:57
asettleHappy to hleps16:57
*** rbowen has quit IRC16:58
*** rbowen has joined #openstack-doc16:58
*** dustins has quit IRC17:16
*** chlong has joined #openstack-doc17:25
*** tylerderosagrund has quit IRC17:25
*** chlong has quit IRC17:27
*** chlong has joined #openstack-doc17:28
setuidSomething very fishy building out the mitaka docs behind a proxy with mitm cert17:32
setuidIt gets through a bunch of the artifact pulls, then dies and times out trying to get to: /cgit/... (any URI), but it seems to have dropped the protocol from the front. Nothing in the entire tree looks like that. I'll get a pastebin.17:33
*** sambetts is now known as sambetts|afk17:57
*** yamamoto has joined #openstack-doc18:09
openstackgerritYuval Brik proposed openstack/openstack-manuals master: Karbor: has admin guide  https://review.openstack.org/48743918:13
setuid Here's what I see: https://paste.debian.net/hidden/122b607f/18:13
*** yamamoto has quit IRC18:13
setuidConnectionError: HTTPSConnectionPool(host='git.openstack.org', port=443): Max retries exceeded with url: /cgit/openstack/cinder/plain/etc/cinder/api-paste.ini?h=mitaka-eol (Caused by NewConnectionError('<urllib3.connection.VerifiedHTTPSConnection object at 0x7f19de96cc10>: Failed to establish a new connection: [Errno 101] Network is unreachable',))18:18
setuidVery fishy, why is the protocol chopped from the front?18:18
setuidLooks like any ref that tries to get to https://github.com/ dies with an SSL timeout18:35
*** sgordon has quit IRC18:41
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: add the documentation for the project data files to the contrib guide  https://review.openstack.org/48755818:53
dhellmannsetuid : it looks like the doc build is trying to include a sample paste file?19:04
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: change config-guide links to the correct "config-reference"  https://review.openstack.org/48756219:04
*** nicolasbock has quit IRC19:06
setuiddhellmann: it looks like py2.7 is tossing on https URIs, and I'm not sure why19:07
setuidI haven't seen this before, specifically with tox, could be something in sphinx19:07
dhellmannyou're behind a proxy?19:07
dhellmanndid you configure tox to pass the proxy variables through?19:07
setuidmitm + ssl proxy19:07
setuid*sheepish grin*, no..  It doesn't read the system environment or system certs?19:08
dhellmannnewer versions only pass through the variables explicitly listed, to ensure no dev settings have a surprise effect on a build19:08
dhellmannyou can pass them on the command line, so you don't have to patch the file19:08
setuiddhellmann: pip is configured to pass the proxy and the mitm cert is correctly injected ('pip search foobar' works as expected)19:10
setuidI'll jfgi and see what I can find19:11
setuidNope, that fails too. Hrmph. https://stackoverflow.com/questions/23663070/setup-https-proxy-for-pip-install-command-within-tox-environment19:13
setuidThis also fails: passenv = http_proxy HTTP_PROXY https_proxy HTTPS_PROXY no_proxy NO_PROXY19:16
setuidI'm going to set this aside, need to take 2 steps back and rethink this19:23
setuidit can't possibly be this hard to reproducibly build these docs19:23
*** rcernin has quit IRC19:27
*** chlong has quit IRC19:43
*** chlong has joined #openstack-doc19:49
*** chlong has quit IRC19:52
*** sgordon has joined #openstack-doc19:52
*** chlong has joined #openstack-doc19:53
dhellmannsetuid : which mitaka docs are you building?19:57
*** gouthamr has quit IRC20:26
*** gouthamr has joined #openstack-doc20:28
notmynameasettle: dhellmann: AFAICT, swift/swiftclient are done with docs migration work https://review.openstack.org/#/c/486189/ https://review.openstack.org/#/c/481221/ and https://review.openstack.org/#/c/481714/20:41
dhellmannnotmyname : let me take a look20:41
dhellmannI don't see a https://docs.openstack.org/swift/latest/configuration/index.html do you have a config reference guide?20:41
dhellmannfor https://review.openstack.org/#/c/486189/ the file should be doc/source/cli/index.rst because the link is going to be to /swift/latest/cli/20:42
dhellmannthere's an admin/index.rst so that looks good20:42
dhellmannditto for install, that looks ok20:43
dhellmannI can remove the config guide from the expected list, if there isn't one20:43
notmynameI don't think there is one. at least not there or called that20:43
dhellmannok20:44
notmynamewe've had https://docs.openstack.org/swift/latest/deployment_guide.html for years that has config stuff in it, but AFAIK there was nothing in -manuals to migrate20:44
dhellmanndoes the thing about the cli file rename make sense?20:44
dhellmannoh, so let me explain better20:44
dhellmannhttps://docs.openstack.org/pike/configuration/ will link to https://docs.openstack.org/swift/latest/configuration/index.html if the latter exists20:45
dhellmannso it's just a matter of deciding if you want that, and if so make sure that configuration/index.html url is valid20:45
dhellmannand then if you do, we'll turn on the flag for has_config_ref20:45
dhellmannthat's how all of the landing pages work for pike and later20:46
dhellmannI'm in the middle of writing docs for how that works now, ironically :-)20:46
dhellmannwe have a few projects that don't have separate config guides, or admin guides, or whatever so it's not that big a deal to be left off of one of the lists20:47
dhellmannat the very worst a project would still be listed on https://docs.openstack.org/pike/projects.html assuming there is any documentation at all20:47
dhellmannso it's just a matter of how many different paths into the docs are useful for readers20:47
dhellmannmake sense?20:47
notmynamehttps://review.openstack.org/#/c/487582/20:48
dhellmannyou'll probably have to update a toctree somewhere, too, but yeah20:48
notmynameright. done20:50
dhellmann+120:50
*** thorst has quit IRC20:50
* notmyname is thinking about the config ref thing20:51
notmynamedhellmann: suppose we don't do the config ref now but want to add it later (as docs are invented). what has to be changed outside of the swift repo to enable all the right links/redirects in the right place?20:53
dhellmannoh, that's totally doable20:53
dhellmannwe will have a separate set of flags for every series, and can update them to add/remove items over time20:53
notmynamedowhere do those flags live?20:54
dhellmannopenstack-manuals/www/project-data/*.yaml20:54
dhellmannlike I said, I'm writing the docs for that right now (literally tabbing between irc and emacs)20:54
dhellmannalthough the readme file in openstack-manuals/www/project-data/README.txt has some basic info20:54
notmynameok, thanks20:55
notmynamefor now, no config guide (ie no configuration/index)20:55
dhellmannok, I'll make a note of that20:56
notmynameso I think that covers it (wrt the docs migration), and further work on docs can proceed within the swift repos20:56
dhellmannyep, I think you're all set20:56
dhellmannthanks!20:56
notmynameok, thanks20:56
notmynameI put a strike on the etherpad. not sure what else to do20:56
dhellmannthanks, that's good20:57
dhellmannI'll update the list in the burndown chart generator and I think that's it for tracking20:57
smcginnisTalking to jungleboyj - we're unclear. Does the docs migration need to happen for the client libs before final cut?20:58
dhellmannsmcginnis : it would really be best to get it done before we branch, yes20:58
smcginnisOr since they can be released at any point after the freeze, do we have more flexibility there?20:58
smcginnisdhellmann: OK, we'll have to rush that through. Thanks!20:58
dhellmannthe issue is in order for the docs to show up under /name/$series after the branch you'd have to backport the docs20:58
dhellmannso you *can* do that, but it'll be more work20:58
smcginnisAh, right. Makes sense.20:59
smcginnisWe can at least get them moved over, then backport any critical formatting and other issues.20:59
dhellmannyeah, land *something* and clean it up over time20:59
jungleboyjsmcginnis:  Looks like we already have the change proposed for cinderclient.  Looking now.21:00
jungleboyjhttps://review.openstack.org/#/c/482083/121:00
dhellmannjungleboyj : you need a cli/index.rst for the link in the template to work properly21:00
*** catintheroof has quit IRC21:01
jungleboyjdhellmann:  Ok, so that patch doesn't have everything we need then ...21:02
dhellmannyeah, it's probably just pulling in the content that already existed, but it doesn't look like it ties it into the build in quite the right way21:03
jungleboyjSo, there is an update to index.rst21:04
jungleboyjSo, cli/index.rst just needs to link to the CLI documentation that exists for Cinder?21:05
dhellmannjungleboyj : right21:06
smcginnisjungleboyj: Want to just update Chason's patch?21:06
dhellmannjungleboyj : we're going to build a link to docs.openstack.org/cinder/latest/cli/21:06
dhellmannwe need something to point to21:06
jungleboyjsmcginnis:  That was what I was going to do.  Trying to figure out what dhellmann  Oh, it looks like swift just made their doc in cli be the index.21:11
dhellmannright21:12
smcginnisSeems to make sense for a client lib.21:12
dhellmannyou can do that, or if you have several pages you can add a toctree page21:12
dhellmannor whatever -- the content is up to you, I only care about the path part :-)21:12
jungleboyjOk, so I am going to rename cinder.rst to be index.rst.21:13
jungleboyjThat will make us compliant.  I will work on making it better in the future.21:13
smcginnisWhatever you decide docboyj. :)21:13
*** chlong has quit IRC21:14
*** yamamoto_ has joined #openstack-doc21:19
*** yamamoto_ has quit IRC21:21
*** efoley has quit IRC21:24
openstackgerritDoug Hellmann proposed openstack/openstack-manuals master: move docs for template generator into the contributor guide  https://review.openstack.org/48759621:28
jungleboyjdhellmann:  Does this look better to you?21:32
jungleboyjhttps://review.openstack.org/#/c/482083/21:32
*** thorst has joined #openstack-doc21:32
dhellmannjungleboyj : that looks pretty good. I'm not sure where doc/source/cli/index.rst appears in a toctree, but if the build works I think you're OK21:33
dhellmannI hate to drop off in the middle of working on this with you, but I have some stuff I have to do IRL21:34
jungleboyjNo problem.  I have some other questions but I can find you tomorrow or something.21:34
jungleboyjdhellmann:  Thanks.  Have a good evening.21:34
dhellmannjungleboyj : if you post the questions here, AJaeger or asettle may be able to help earlier tomorrow than me, too21:35
jungleboyjdhellmann:  Ok, sounds good.  Thank you sir!21:35
*** thorst has quit IRC21:37
*** edmondsw has quit IRC21:58
*** thorst has joined #openstack-doc22:25
*** thorst has quit IRC22:26
*** gouthamr has quit IRC22:28
*** suyog has joined #openstack-doc22:34
*** gouthamr has joined #openstack-doc22:42
*** edmondsw has joined #openstack-doc23:06
*** yamamoto has joined #openstack-doc23:10
*** edmondsw has quit IRC23:11
*** thorst has joined #openstack-doc23:27
*** thorst has quit IRC23:32
*** yamamoto has quit IRC23:37
*** thorst has joined #openstack-doc23:50
*** thorst has quit IRC23:50
*** yamamoto has joined #openstack-doc23:51
*** yamamoto_ has joined #openstack-doc23:55
*** yamamoto has quit IRC23:56

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