*** masaki has joined #openstack-doc | 00:02 | |
*** yamamoto has quit IRC | 00:10 | |
*** yamamoto has joined #openstack-doc | 00:11 | |
*** gmann has quit IRC | 00:15 | |
*** gmann has joined #openstack-doc | 00:15 | |
*** edmondsw has joined #openstack-doc | 00:20 | |
*** fragatina has quit IRC | 00:23 | |
*** edmondsw has quit IRC | 00:25 | |
*** skelso has joined #openstack-doc | 00:28 | |
*** thorst has joined #openstack-doc | 00:29 | |
*** thorst has quit IRC | 00:33 | |
*** thorst has joined #openstack-doc | 00:59 | |
*** s-shiono has joined #openstack-doc | 01:01 | |
*** phuongnh has joined #openstack-doc | 01:02 | |
*** thorst has quit IRC | 01:07 | |
*** dmacpher has joined #openstack-doc | 01:16 | |
*** lucasxu has joined #openstack-doc | 01:22 | |
*** lucasxu has quit IRC | 01:24 | |
*** mriedem has quit IRC | 01:29 | |
*** masaki has quit IRC | 01:45 | |
*** masaki has joined #openstack-doc | 01:49 | |
*** mihalis68 has joined #openstack-doc | 01:51 | |
*** edmondsw has joined #openstack-doc | 02:08 | |
*** masaki has quit IRC | 02:11 | |
*** masaki has joined #openstack-doc | 02:11 | |
*** edmondsw has quit IRC | 02:13 | |
*** gaurangt has quit IRC | 02:22 | |
*** gaurangt has joined #openstack-doc | 02:25 | |
*** gouthamr has joined #openstack-doc | 02:31 | |
*** skelso has quit IRC | 02:32 | |
*** edmondsw has joined #openstack-doc | 03:57 | |
*** fragatina has joined #openstack-doc | 03:57 | |
*** fragatina has quit IRC | 04:00 | |
*** fragatina has joined #openstack-doc | 04:01 | |
*** edmondsw has quit IRC | 04:01 | |
*** mihalis68 has quit IRC | 04:01 | |
*** nicolasbock has joined #openstack-doc | 04:04 | |
*** deep-book-gk_ has joined #openstack-doc | 04:32 | |
*** deep-book-gk_ has left #openstack-doc | 04:33 | |
*** suyog has quit IRC | 04:46 | |
*** vharsh has joined #openstack-doc | 04:56 | |
*** charcol has quit IRC | 04:58 | |
*** gouthamr has quit IRC | 05:00 | |
*** suyog has joined #openstack-doc | 05:03 | |
*** thorst has joined #openstack-doc | 05:04 | |
*** thorst has quit IRC | 05:10 | |
*** masaki has quit IRC | 05:20 | |
*** masaki has joined #openstack-doc | 05:21 | |
*** edmondsw has joined #openstack-doc | 05:45 | |
*** edmondsw has quit IRC | 05:49 | |
*** dmacpher has quit IRC | 05:56 | |
*** fragatina has quit IRC | 06:03 | |
*** fragatina has joined #openstack-doc | 06:05 | |
*** rcernin has joined #openstack-doc | 06:06 | |
*** fragatina has quit IRC | 06:08 | |
*** andreas_s has joined #openstack-doc | 06:09 | |
*** dmacpher has joined #openstack-doc | 06:13 | |
*** thorst has joined #openstack-doc | 06:29 | |
openstackgerrit | Chason Chan proposed openstack/openstack-doc-tools master: Make openstack-doc-tools can be used in the individual client repos https://review.openstack.org/487292 | 06:30 |
---|---|---|
*** thorst has quit IRC | 06:33 | |
AJaeger | dhellmann: wow, great automation! | 06:36 |
*** suyog has quit IRC | 06:46 | |
*** yamamoto has quit IRC | 06:54 | |
*** belmoreira has joined #openstack-doc | 07:05 | |
*** dmacpher has quit IRC | 07:17 | |
*** edmondsw has joined #openstack-doc | 07:33 | |
*** edmondsw has quit IRC | 07:37 | |
*** masaki has quit IRC | 07:39 | |
*** alexchadin has joined #openstack-doc | 07:43 | |
*** yamamoto has joined #openstack-doc | 07:55 | |
*** yamamoto has quit IRC | 08:02 | |
*** s-shiono has quit IRC | 08:23 | |
*** efoley has joined #openstack-doc | 08:23 | |
*** efoley_ has joined #openstack-doc | 08:24 | |
*** efoley has quit IRC | 08:24 | |
*** thorst has joined #openstack-doc | 08:30 | |
*** thorst has quit IRC | 08:34 | |
*** efoley_ is now known as efoley | 08:35 | |
*** stevemar has quit IRC | 08:36 | |
*** stevemar has joined #openstack-doc | 08:36 | |
asettle | Morning o/ | 08:45 |
*** katyafervent_awa has quit IRC | 09:20 | |
*** katyafervent_awa has joined #openstack-doc | 09:20 | |
*** stephenfin has quit IRC | 09:21 | |
*** KeithMnemonic2 has joined #openstack-doc | 09:22 | |
*** suyog has joined #openstack-doc | 09:22 | |
*** suyog has quit IRC | 09:22 | |
*** edmondsw has joined #openstack-doc | 09:22 | |
*** KeithMnemonic1 has quit IRC | 09:22 | |
AJaeger | morning, asettle ! | 09:23 |
*** odyssey4me has quit IRC | 09:23 | |
*** stephenfin has joined #openstack-doc | 09:24 | |
*** yamamoto has joined #openstack-doc | 09:24 | |
*** edmondsw has quit IRC | 09:25 | |
*** odyssey4me has joined #openstack-doc | 09:27 | |
*** yamamoto has quit IRC | 09:35 | |
openstackgerrit | Merged openstack/openstack-manuals master: the mistral team deleted their admin guide landing page https://review.openstack.org/487209 | 09:38 |
openstackgerrit | Merged openstack/openstack-manuals master: add landing pages for historical versions https://review.openstack.org/487197 | 09:38 |
openstackgerrit | Merged openstack/openstackdocstheme master: move the localtoc for the page into the sidebar https://review.openstack.org/487103 | 09:39 |
openstackgerrit | Merged openstack/openstackdocstheme master: Serve minified CSS https://review.openstack.org/486956 | 09:40 |
*** sambetts|afk is now known as sambetts | 09:40 | |
*** yamamoto has joined #openstack-doc | 09:45 | |
openstackgerrit | Merged openstack/openstack-manuals master: update release dates and status on all landing pages https://review.openstack.org/487198 | 09:45 |
openstackgerrit | Merged openstack/openstack-manuals master: move series dates into generator https://review.openstack.org/487199 | 09:45 |
openstackgerrit | Merged openstack/openstack-manuals master: use SERIES_INFO to pick up the message to describe the series status https://review.openstack.org/487200 | 09:45 |
openstackgerrit | Merged openstack/openstack-manuals master: move repetitive content from the index pages to the indexbase template https://review.openstack.org/487201 | 09:45 |
openstackgerrit | Merged openstack/openstack-manuals master: link to keystone admin and config guides https://review.openstack.org/487026 | 09:45 |
*** alexchadin has quit IRC | 09:46 | |
*** thorst has joined #openstack-doc | 09:58 | |
openstackgerrit | Sharat Sharma proposed openstack/openstack-manuals master: Revert "the mistral team deleted their admin guide landing page" https://review.openstack.org/487352 | 10:00 |
*** thorst has quit IRC | 10:06 | |
*** thorst has joined #openstack-doc | 10:07 | |
*** thorst has quit IRC | 10:11 | |
*** phuongnh has quit IRC | 10:20 | |
openstackgerrit | Sharat Sharma proposed openstack/openstack-manuals master: Revert "the mistral team deleted their admin guide landing page" https://review.openstack.org/487352 | 10:21 |
AJaeger | asettle: a docs-specs change for review https://review.openstack.org/487204 (low prio) | 10:34 |
AJaeger | asettle, dhellmann : and one for openstack-doc-tools, please: https://review.openstack.org/487151 | 10:34 |
asettle | OH thanks, I missed that one | 10:35 |
openstackgerrit | Merged openstack/docs-specs master: switch to openstackdocstheme https://review.openstack.org/487204 | 10:39 |
*** edmondsw has joined #openstack-doc | 11:09 | |
asettle | brb :) | 11:10 |
*** edmondsw has quit IRC | 11:13 | |
openstackgerrit | Rob Cresswell proposed openstack/openstackdocstheme master: Fix a logic issue in the JS https://review.openstack.org/487378 | 11:44 |
robcresswell | asettle, AJaeger: ^^ That fixes a logic issue I introduced | 11:44 |
robcresswell | *hangs head in shame* | 11:44 |
robcresswell | Rushed a patch and didn't properly consider my jquery :) | 11:45 |
*** vharsh has quit IRC | 11:47 | |
AJaeger | robcresswell: for the change that merged today - or do we need a new release? | 11:50 |
robcresswell | Its 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 |
robcresswell | I didnt catch it on the demo page, because that only does one of each. | 11:51 |
robcresswell | So yeah, made a dum on my selector logic. My fault, shouldn't have rushed it. | 11:52 |
robcresswell | Anyway, thats the fix :) | 11:52 |
AJaeger | robcresswell: can you update the demo page, please? | 11:52 |
AJaeger | I'm busy the rest of the day, hope others can review and help with a release. | 11:52 |
setuid | For those that received it, did the email I just sent to -docs clarify what we discussed yesterday? | 11:52 |
AJaeger | Thanks a lot for catching and releasing | 11:53 |
AJaeger | bbl | 11:53 |
robcresswell | Sure | 11:53 |
openstackgerrit | Rob Cresswell proposed openstack/openstackdocstheme master: Fix a logic issue in the JS https://review.openstack.org/487378 | 11:55 |
*** yamamoto has quit IRC | 11:57 | |
*** vharsh has joined #openstack-doc | 12:00 | |
*** Dinesh_Bhor is now known as Dinesh_Bhor|away | 12:08 | |
*** Dinesh_Bhor|away is now known as Dinesh_Bhor | 12:09 | |
*** yamamoto has joined #openstack-doc | 12:13 | |
*** edmondsw has joined #openstack-doc | 12:13 | |
*** thorst has joined #openstack-doc | 12:16 | |
*** chlong has joined #openstack-doc | 12:16 | |
dhellmann | AJaeger, asettle : o/ | 12:18 |
robcresswell | dhellmann: If you read the scrollback a few lines, there's a small bugfix there ^^ | 12:18 |
dhellmann | looking | 12:19 |
robcresswell | if you have time ofc. It's relatively minor. | 12:19 |
dhellmann | +2 from me | 12:20 |
dhellmann | should we go ahead and hold any new theme release to wait for this? | 12:21 |
*** catintheroof has joined #openstack-doc | 12:21 | |
robcresswell | dhellmann: I think so, yes | 12:22 |
*** vharsh has quit IRC | 12:22 | |
dhellmann | ok, noted | 12:22 |
robcresswell | I'll fill out that demo page a little more as well, so any issues are more apparent. | 12:22 |
robcresswell | In a separate patch, that is. | 12:22 |
openstackgerrit | Merged openstack/openstackdocstheme master: Fix a logic issue in the JS https://review.openstack.org/487378 | 12:24 |
AJaeger | dhellmann: +2A, so merged ^ | 12:25 |
AJaeger | dhellmann, asettle : Anybody wants to do a new release -or should we wait? | 12:25 |
dhellmann | robcresswell : that would be good, thanks | 12:25 |
dhellmann | AJaeger : let's do it today so we can branch | 12:25 |
* dhellmann check that we do branch the theme | 12:25 | |
dhellmann | oh, I guess not | 12:26 |
*** mriedem has joined #openstack-doc | 12:39 | |
*** mriedem has left #openstack-doc | 12:40 | |
*** mriedem has joined #openstack-doc | 12:40 | |
*** efoley has quit IRC | 12:47 | |
asettle | dhellmann: what happend? | 12:50 |
asettle | WHat'd we do? | 12:50 |
*** efoley has joined #openstack-doc | 12:50 | |
*** egallen has joined #openstack-doc | 12:53 | |
asettle | Nice summary setuid :D | 12:53 |
asettle | Thanks pal | 12:53 |
*** yamamoto has quit IRC | 12:54 | |
*** tylerderosagrund has joined #openstack-doc | 12:55 | |
dhellmann | asettle : robcresswell fixed a bug in the theme, I was suggesting we wait to release after that has merged | 12:55 |
asettle | Neat :) | 12:56 |
*** dustins has joined #openstack-doc | 13:01 | |
*** tylerderosagrund has quit IRC | 13:04 | |
AJaeger | https://review.openstack.org/487409 is the openstackdocstheme 1.16 release | 13:06 |
AJaeger | dhellmann: we'Re not branching so far... | 13:06 |
openstackgerrit | Doug Hellmann proposed openstack/openstack-manuals master: add links to docs for more pike projects https://review.openstack.org/487411 | 13:06 |
dhellmann | AJaeger : yeah, that makes sense | 13:06 |
dhellmann | I'll watch for the jobs to finish on that release patch and then review it | 13:07 |
*** yamamoto has joined #openstack-doc | 13:09 | |
*** tylerderosagrund has joined #openstack-doc | 13:12 | |
tylerderosagrund | Good morning all | 13:13 |
*** dustins has quit IRC | 13:18 | |
AJaeger | robcresswell, dhellmann, asettle openstackdocstheme 1.16 is released - now update for upper-constraints.txt is the one thing we need before it'S used everywhere | 13:23 |
asettle | Okay :) | 13:26 |
*** catintheroof has quit IRC | 13:44 | |
*** yuval has joined #openstack-doc | 13:45 | |
setuid | asettle: Did I miss anything important? I guess we could peel back the layers in the coming days on the ML | 13:46 |
*** catintheroof has joined #openstack-doc | 13:46 | |
asettle | setuid: I don't think so :) | 13:46 |
yuval | Hey :) 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 IRC | 13:48 | |
*** catintheroof has joined #openstack-doc | 13:48 | |
AJaeger | yuval: check status.openstack.org/zuul | 13:51 |
*** catintheroof has quit IRC | 13:51 | |
AJaeger | PUblishing is done as part of a post job, and then needs 5 mins to sync. | 13:51 |
AJaeger | So, has your job run? | 13:51 |
AJaeger | yuval: read also https://docs.openstack.org/contributor-guide/landing-pages.html to link to it | 13:52 |
*** catintheroof has joined #openstack-doc | 13:52 | |
*** rcernin has quit IRC | 13:54 | |
yuval | AJaeger: probably that | 13:54 |
yuval | AJaeger: thanks! | 13:54 |
*** donghao has joined #openstack-doc | 13:58 | |
*** dustins has joined #openstack-doc | 14:06 | |
*** xiaofandh12 has joined #openstack-doc | 14:08 | |
*** donghao has quit IRC | 14:08 | |
*** dustins has quit IRC | 14:09 | |
*** dustins has joined #openstack-doc | 14:09 | |
openstackgerrit | Yuval Brik proposed openstack/openstack-manuals master: Karbor: has admin, install, config guides https://review.openstack.org/487439 | 14:09 |
*** gouthamr has joined #openstack-doc | 14:12 | |
*** dustins has quit IRC | 14:19 | |
*** dustins has joined #openstack-doc | 14:20 | |
*** dustins has quit IRC | 14:21 | |
AJaeger | yuval: recheck your change once the content is published, we check that it exists ^ | 14:21 |
*** dustins has joined #openstack-doc | 14:21 | |
*** dustins has quit IRC | 14:21 | |
*** dustins has joined #openstack-doc | 14:22 | |
*** dustins has quit IRC | 14:22 | |
*** dustins has joined #openstack-doc | 14:23 | |
*** yamamoto has quit IRC | 14:24 | |
*** dustins has quit IRC | 14:35 | |
*** dustins has joined #openstack-doc | 14:36 | |
*** dustins has quit IRC | 14:37 | |
yuval | AJaeger: will do, thanks :) | 14:38 |
dhellmann | setuid : which list did your message go to? I haven't seen it yet, and I want to make sure I'm on all the lists | 14:41 |
asettle | dhellmann: docs yo :) | 14:58 |
asettle | setuid: yo bro you makin' me read so muchhhh | 15:08 |
*** dustins has joined #openstack-doc | 15:12 | |
dhellmann | asettle : I thought I signed up for that one. How many lists does this team have!? :-) | 15:19 |
setuid | asettle: Sorry! I prefer to be verbose, clarify the bits | 15:19 |
asettle | dhellmann: thankfully just one. Would you like me to forward? Fairly sure you did sign up! | 15:20 |
asettle | setuid: I'm just joshing mannnnn :D | 15:20 |
dhellmann | asettle : yeah, please, that way I can check my mail filters to see what happened to the original | 15:20 |
asettle | You got it :) | 15:20 |
*** rcernin has joined #openstack-doc | 15:21 | |
* dhellmann tips his hat to asettle | 15:22 | |
asettle | http://i.imgur.com/Zw468as.png | 15:24 |
*** yamamoto has joined #openstack-doc | 15:24 | |
AJaeger | dhellmann: could you review https://review.openstack.org/487151 , please? This is for our tool generating the sitemap | 15:25 |
dhellmann | AJaeger : do you want to go ahead and add pike? | 15:25 |
dhellmann | +2a on that one in the mean time | 15:26 |
AJaeger | dhellmann: no, pike is current - we only add *old* releases... | 15:28 |
dhellmann | ah | 15:28 |
AJaeger | And yes, this could use some refinement with old and really old releases. | 15:28 |
AJaeger | setuid: something you might be interested in as well, see 487151 | 15:28 |
*** belmoreira has quit IRC | 15:29 | |
dhellmann | oh, ffs, why is mail delivery disabled for me on that list | 15:31 |
dhellmann | AJaeger : 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 published | 15:31 |
setuid | AJaeger: I'll add that to my build bootstrap and see what (if anything) needs to be done to build it | 15:31 |
openstackgerrit | Merged openstack/openstack-doc-tools master: sitemap: Add ocata https://review.openstack.org/487151 | 15:33 |
*** rcernin has quit IRC | 15:34 | |
* dhellmann imports 600+ messages from the docs ML archives so he can catch up | 15:34 | |
*** andreas_s has quit IRC | 15:35 | |
*** yamamoto has quit IRC | 15:36 | |
AJaeger | dhellmann: yeah, there are various options open. Just wanted to point out current basic approach | 15:44 |
asettle | dhellmann: why weren't those emails going through to you? I was certain you were subscribed | 15:51 |
dhellmann | asettle: I was susbscribed but had apparently set the flag to disable mail delivery at some point in the past | 15:52 |
dhellmann | I'm reading the last 3 months archives as penance | 15:52 |
asettle | dhellmann: oh I see how it is | 15:52 |
asettle | Eh, there's nothing exciting :P | 15:52 |
dhellmann | I may have to grab the archives again tomorrow after the thread I was actually trying to follow is added to the zip file | 15:55 |
dhellmann | asettle : 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 it | 15:59 |
*** imacdonn_ has quit IRC | 15:59 | |
*** imacdonn_ has joined #openstack-doc | 15:59 | |
dhellmann | I know that means asking docs team members to deal with an extremely busy mailing list | 15:59 |
asettle | Probably right about time to switch over - maybe it's worth starting the convo, and ensuring it is achieved for the start of Queens | 16:00 |
asettle | Would make sense | 16:00 |
dhellmann | should I propose that? | 16:00 |
dhellmann | I suppose *that* conversation should happen on the docs list | 16:01 |
*** rcernin has joined #openstack-doc | 16:03 | |
*** chlong has quit IRC | 16:08 | |
dhellmann | done | 16:09 |
*** xiaofandh12 has quit IRC | 16:10 | |
AJaeger | asettle: want to +2a https://review.openstack.org/487411 ? | 16:48 |
asettle | dhellmann: yeah probably :) | 16:51 |
asettle | AJaeger: on it | 16:51 |
openstackgerrit | Merged openstack/openstack-manuals master: add links to docs for more pike projects https://review.openstack.org/487411 | 16:57 |
AJaeger | thanks, asettle | 16:57 |
asettle | Happy to hleps | 16:57 |
*** rbowen has quit IRC | 16:58 | |
*** rbowen has joined #openstack-doc | 16:58 | |
*** dustins has quit IRC | 17:16 | |
*** chlong has joined #openstack-doc | 17:25 | |
*** tylerderosagrund has quit IRC | 17:25 | |
*** chlong has quit IRC | 17:27 | |
*** chlong has joined #openstack-doc | 17:28 | |
setuid | Something very fishy building out the mitaka docs behind a proxy with mitm cert | 17:32 |
setuid | It 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|afk | 17:57 | |
*** yamamoto has joined #openstack-doc | 18:09 | |
openstackgerrit | Yuval Brik proposed openstack/openstack-manuals master: Karbor: has admin guide https://review.openstack.org/487439 | 18:13 |
setuid | Here's what I see: https://paste.debian.net/hidden/122b607f/ | 18:13 |
*** yamamoto has quit IRC | 18:13 | |
setuid | ConnectionError: 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 |
setuid | Very fishy, why is the protocol chopped from the front? | 18:18 |
setuid | Looks like any ref that tries to get to https://github.com/ dies with an SSL timeout | 18:35 |
*** sgordon has quit IRC | 18:41 | |
openstackgerrit | Doug Hellmann proposed openstack/openstack-manuals master: add the documentation for the project data files to the contrib guide https://review.openstack.org/487558 | 18:53 |
dhellmann | setuid : it looks like the doc build is trying to include a sample paste file? | 19:04 |
openstackgerrit | Doug Hellmann proposed openstack/openstack-manuals master: change config-guide links to the correct "config-reference" https://review.openstack.org/487562 | 19:04 |
*** nicolasbock has quit IRC | 19:06 | |
setuid | dhellmann: it looks like py2.7 is tossing on https URIs, and I'm not sure why | 19:07 |
setuid | I haven't seen this before, specifically with tox, could be something in sphinx | 19:07 |
dhellmann | you're behind a proxy? | 19:07 |
dhellmann | did you configure tox to pass the proxy variables through? | 19:07 |
setuid | mitm + ssl proxy | 19:07 |
setuid | *sheepish grin*, no.. It doesn't read the system environment or system certs? | 19:08 |
dhellmann | newer versions only pass through the variables explicitly listed, to ensure no dev settings have a surprise effect on a build | 19:08 |
dhellmann | you can pass them on the command line, so you don't have to patch the file | 19:08 |
setuid | dhellmann: pip is configured to pass the proxy and the mitm cert is correctly injected ('pip search foobar' works as expected) | 19:10 |
setuid | I'll jfgi and see what I can find | 19:11 |
setuid | Nope, that fails too. Hrmph. https://stackoverflow.com/questions/23663070/setup-https-proxy-for-pip-install-command-within-tox-environment | 19:13 |
setuid | This also fails: passenv = http_proxy HTTP_PROXY https_proxy HTTPS_PROXY no_proxy NO_PROXY | 19:16 |
setuid | I'm going to set this aside, need to take 2 steps back and rethink this | 19:23 |
setuid | it can't possibly be this hard to reproducibly build these docs | 19:23 |
*** rcernin has quit IRC | 19:27 | |
*** chlong has quit IRC | 19:43 | |
*** chlong has joined #openstack-doc | 19:49 | |
*** chlong has quit IRC | 19:52 | |
*** sgordon has joined #openstack-doc | 19:52 | |
*** chlong has joined #openstack-doc | 19:53 | |
dhellmann | setuid : which mitaka docs are you building? | 19:57 |
*** gouthamr has quit IRC | 20:26 | |
*** gouthamr has joined #openstack-doc | 20:28 | |
notmyname | asettle: 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 |
dhellmann | notmyname : let me take a look | 20:41 |
dhellmann | I don't see a https://docs.openstack.org/swift/latest/configuration/index.html do you have a config reference guide? | 20:41 |
dhellmann | for 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 |
dhellmann | there's an admin/index.rst so that looks good | 20:42 |
dhellmann | ditto for install, that looks ok | 20:43 |
dhellmann | I can remove the config guide from the expected list, if there isn't one | 20:43 |
notmyname | I don't think there is one. at least not there or called that | 20:43 |
dhellmann | ok | 20:44 |
notmyname | we'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 migrate | 20:44 |
dhellmann | does the thing about the cli file rename make sense? | 20:44 |
dhellmann | oh, so let me explain better | 20:44 |
dhellmann | https://docs.openstack.org/pike/configuration/ will link to https://docs.openstack.org/swift/latest/configuration/index.html if the latter exists | 20:45 |
dhellmann | so it's just a matter of deciding if you want that, and if so make sure that configuration/index.html url is valid | 20:45 |
dhellmann | and then if you do, we'll turn on the flag for has_config_ref | 20:45 |
dhellmann | that's how all of the landing pages work for pike and later | 20:46 |
dhellmann | I'm in the middle of writing docs for how that works now, ironically :-) | 20:46 |
dhellmann | we 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 lists | 20:47 |
dhellmann | at the very worst a project would still be listed on https://docs.openstack.org/pike/projects.html assuming there is any documentation at all | 20:47 |
dhellmann | so it's just a matter of how many different paths into the docs are useful for readers | 20:47 |
dhellmann | make sense? | 20:47 |
notmyname | https://review.openstack.org/#/c/487582/ | 20:48 |
dhellmann | you'll probably have to update a toctree somewhere, too, but yeah | 20:48 |
notmyname | right. done | 20:50 |
dhellmann | +1 | 20:50 |
*** thorst has quit IRC | 20:50 | |
* notmyname is thinking about the config ref thing | 20:51 | |
notmyname | dhellmann: 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 |
dhellmann | oh, that's totally doable | 20:53 |
dhellmann | we will have a separate set of flags for every series, and can update them to add/remove items over time | 20:53 |
notmyname | dowhere do those flags live? | 20:54 |
dhellmann | openstack-manuals/www/project-data/*.yaml | 20:54 |
dhellmann | like I said, I'm writing the docs for that right now (literally tabbing between irc and emacs) | 20:54 |
dhellmann | although the readme file in openstack-manuals/www/project-data/README.txt has some basic info | 20:54 |
notmyname | ok, thanks | 20:55 |
notmyname | for now, no config guide (ie no configuration/index) | 20:55 |
dhellmann | ok, I'll make a note of that | 20:56 |
notmyname | so I think that covers it (wrt the docs migration), and further work on docs can proceed within the swift repos | 20:56 |
dhellmann | yep, I think you're all set | 20:56 |
dhellmann | thanks! | 20:56 |
notmyname | ok, thanks | 20:56 |
notmyname | I put a strike on the etherpad. not sure what else to do | 20:56 |
dhellmann | thanks, that's good | 20:57 |
dhellmann | I'll update the list in the burndown chart generator and I think that's it for tracking | 20:57 |
smcginnis | Talking to jungleboyj - we're unclear. Does the docs migration need to happen for the client libs before final cut? | 20:58 |
dhellmann | smcginnis : it would really be best to get it done before we branch, yes | 20:58 |
smcginnis | Or since they can be released at any point after the freeze, do we have more flexibility there? | 20:58 |
smcginnis | dhellmann: OK, we'll have to rush that through. Thanks! | 20:58 |
dhellmann | the issue is in order for the docs to show up under /name/$series after the branch you'd have to backport the docs | 20:58 |
dhellmann | so you *can* do that, but it'll be more work | 20:58 |
smcginnis | Ah, right. Makes sense. | 20:59 |
smcginnis | We can at least get them moved over, then backport any critical formatting and other issues. | 20:59 |
dhellmann | yeah, land *something* and clean it up over time | 20:59 |
jungleboyj | smcginnis: Looks like we already have the change proposed for cinderclient. Looking now. | 21:00 |
jungleboyj | https://review.openstack.org/#/c/482083/1 | 21:00 |
dhellmann | jungleboyj : you need a cli/index.rst for the link in the template to work properly | 21:00 |
*** catintheroof has quit IRC | 21:01 | |
jungleboyj | dhellmann: Ok, so that patch doesn't have everything we need then ... | 21:02 |
dhellmann | yeah, 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 way | 21:03 |
jungleboyj | So, there is an update to index.rst | 21:04 |
jungleboyj | So, cli/index.rst just needs to link to the CLI documentation that exists for Cinder? | 21:05 |
dhellmann | jungleboyj : right | 21:06 |
smcginnis | jungleboyj: Want to just update Chason's patch? | 21:06 |
dhellmann | jungleboyj : we're going to build a link to docs.openstack.org/cinder/latest/cli/ | 21:06 |
dhellmann | we need something to point to | 21:06 |
jungleboyj | smcginnis: 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 |
dhellmann | right | 21:12 |
smcginnis | Seems to make sense for a client lib. | 21:12 |
dhellmann | you can do that, or if you have several pages you can add a toctree page | 21:12 |
dhellmann | or whatever -- the content is up to you, I only care about the path part :-) | 21:12 |
jungleboyj | Ok, so I am going to rename cinder.rst to be index.rst. | 21:13 |
jungleboyj | That will make us compliant. I will work on making it better in the future. | 21:13 |
smcginnis | Whatever you decide docboyj. :) | 21:13 |
*** chlong has quit IRC | 21:14 | |
*** yamamoto_ has joined #openstack-doc | 21:19 | |
*** yamamoto_ has quit IRC | 21:21 | |
*** efoley has quit IRC | 21:24 | |
openstackgerrit | Doug Hellmann proposed openstack/openstack-manuals master: move docs for template generator into the contributor guide https://review.openstack.org/487596 | 21:28 |
jungleboyj | dhellmann: Does this look better to you? | 21:32 |
jungleboyj | https://review.openstack.org/#/c/482083/ | 21:32 |
*** thorst has joined #openstack-doc | 21:32 | |
dhellmann | jungleboyj : 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 OK | 21:33 |
dhellmann | I hate to drop off in the middle of working on this with you, but I have some stuff I have to do IRL | 21:34 |
jungleboyj | No problem. I have some other questions but I can find you tomorrow or something. | 21:34 |
jungleboyj | dhellmann: Thanks. Have a good evening. | 21:34 |
dhellmann | jungleboyj : if you post the questions here, AJaeger or asettle may be able to help earlier tomorrow than me, too | 21:35 |
jungleboyj | dhellmann: Ok, sounds good. Thank you sir! | 21:35 |
*** thorst has quit IRC | 21:37 | |
*** edmondsw has quit IRC | 21:58 | |
*** thorst has joined #openstack-doc | 22:25 | |
*** thorst has quit IRC | 22:26 | |
*** gouthamr has quit IRC | 22:28 | |
*** suyog has joined #openstack-doc | 22:34 | |
*** gouthamr has joined #openstack-doc | 22:42 | |
*** edmondsw has joined #openstack-doc | 23:06 | |
*** yamamoto has joined #openstack-doc | 23:10 | |
*** edmondsw has quit IRC | 23:11 | |
*** thorst has joined #openstack-doc | 23:27 | |
*** thorst has quit IRC | 23:32 | |
*** yamamoto has quit IRC | 23:37 | |
*** thorst has joined #openstack-doc | 23:50 | |
*** thorst has quit IRC | 23:50 | |
*** yamamoto has joined #openstack-doc | 23:51 | |
*** yamamoto_ has joined #openstack-doc | 23:55 | |
*** yamamoto has quit IRC | 23:56 |
Generated by irclog2html.py 2.15.3 by Marius Gedminas - find it at mg.pov.lt!