21:00:05 #startmeeting docteam 21:00:06 Meeting started Thu Jan 12 21:00:05 2017 UTC and is due to finish in 60 minutes. The chair is loquacities. Information about MeetBot at http://wiki.debian.org/MeetBot. 21:00:07 Useful Commands: #action #agreed #help #info #idea #link #topic #startvote. 21:00:09 The meeting name has been set to 'docteam' 21:00:14 hi everyone! 21:00:20 o/ 21:00:29 hi! 21:01:14 #topic Action items from the last meeting 21:01:19 Hello o/ 21:01:31 so, there's a couple here for me that i haven't done :S 21:01:47 loquacities to follow up on both specs in the new year on the mailing list 21:01:53 ^^ i will do that today 21:01:56 hi :) 21:02:00 iphutch to chase up the security speciality team to discuss future of guide (with asettle and loquacities) 21:02:07 is iphutch or asettle here? 21:02:11 Hello! 21:02:15 oh hi! 21:02:21 greetings 21:02:27 Greetings 21:02:36 wow, full house :) 21:03:03 Followed up with sicarie (are you here?) 21:03:48 i don't think he is 21:03:51 and it looks like the security guide is hitting bumps in the road nested around finding sees for the projects that need most updating: neutron and nova 21:04:02 * SMEs 21:04:09 ah, right 21:04:44 i assume you've started with the cross-project liaisons for those projects? 21:04:45 iphutch that could change as the release dates scurry along 21:04:55 iphutch might be a timing thing as much as a finding thing 21:05:01 that's a good point, too 21:05:06 Best efforts as of right now is looking at code within those projects and trying to figure out what their sec. best practices are but it is a big ask in terms of availability 21:05:12 loquacities it's a hunch anyway 21:05:31 gotcha 21:05:44 and, finally, it's me again: 21:05:46 loquacities to ping Richard Jones about cinder commands in horizon 21:05:50 i will also do that today 21:06:02 #topic Specs in review 21:06:09 #link https://review.openstack.org/#/q/status:open+project:openstack/docs-specs,n,z 21:06:24 it's still just that use case form 21:06:35 can we abandon this now? 21:06:45 AJaeger? 21:06:53 https://review.openstack.org/#/c/391786/ 21:07:23 * AJaeger checks 21:07:32 yeah... 21:07:49 shall I? 21:08:10 done :) 21:08:22 let's move on to speciality teams 21:08:27 #topic Speciality teams reports: 21:08:34 API: Anne Gentle 21:08:50 annegentle: ? 21:09:08 So hopefully you saw on the ML that I'm working on retiring fairy-slipper 21:09:33 It was a good tool, served its purpose, and can now traipse into the sunset. 21:09:39 yay! 21:09:45 #info Retiring fairy-slipper 21:10:00 And thanks to AJaeger and stevemar for the help with the patches 21:10:40 It's not done yet, but patches are in place. 21:11:01 Also in API land, be sure to follow the service catalog naming conventions work going on in the API WG 21:11:07 annegentle: go ahead and merge ;) 21:11:21 AJaeger heh. don't have +2 everywhere 21:12:01 And there's also a new ec2 api reference: http://developer.openstack.org/api-ref/ec2-api/ 21:12:17 Mostly describes the limitations 21:12:49 I think that's it. Any questions for API landia? 21:12:58 annegentle: you have +2 in fairy-slipper - and a few others as well: https://review.openstack.org/#/admin/groups/1240,members 21:13:24 cool, thanks annegentle 21:13:31 Configuration Reference and CLI Reference: Tomoyuki Kato 21:13:41 i don't think katomo is here, this is what he gave me on email: 21:13:47 Config Reference: Updated a few plug-ins content. 21:13:52 CLI reference: UPdated a few command reference. Unsupport Block Storage API v1 and Image API v1 from the reference. 21:14:12 High Availability Guide: Andrew Beekhof 21:14:28 anyone have updates on the HA Guide? 21:15:05 i'll take that as a no 21:15:06 does Andrew have an IRC nick? 21:15:19 annegentle: i'm not certain i've ever seen him on IRC 21:15:28 Hypervisor Tuning Guide: Joe Topjian 21:15:40 i haven't heard from joe in a while, i should probably ping him 21:15:52 kk 21:15:56 #action loquacities to ping joe topjian re: hypervisor tuning guide 21:16:07 Installation guides: Lana Brindley 21:16:29 obviously, i've been on holiday, so no real update from me. however, we'll need to start testing for ocata RSN 21:16:46 ++ 21:16:47 Networking Guide: John Davidge 21:17:27 anyone with updates from the networking guide? 21:18:04 ok, moving on 21:18:11 Operations and Architecture Design guides: Shilla Saebi 21:18:24 darrenc: can you fill us in? 21:18:30 sure thing 21:18:37 Nothing much to report. Ben Silverman has spent some time refining the Compute content in the Arch Guide draft. Thanks Ben! 21:18:54 We are also looking for more SMEs to help with the Arch Guide. So if you're interested, contact asettle or me :) 21:18:54 cool 21:19:15 I think that's it 21:19:20 thanks :) 21:19:25 Security Guide: Nathaniel Dillon 21:19:26 np 21:19:37 we know sicarie isn't here 21:19:43 anyone else with security guide updates? 21:20:04 Just what I stated earlier 21:20:08 cool 21:20:13 Training Guides: Matjaz Pancur 21:20:48 i haven't heard from matjaz in a little while 21:20:54 any training guides people here? 21:21:26 ok, let's move on 21:21:31 Training labs: Pranav Salunke, Roger Luethi 21:22:00 dguitarbite? 21:22:02 nope 21:22:12 i can say that this patch merged: https://review.openstack.org/#/c/412405/ 21:22:24 i'm not sure it's ready to actually use yet, but there it is 21:22:52 and, finally ... 21:22:54 User guides: Joseph Robinson 21:22:55 they're working now together on the parser and CI 21:23:02 neato 21:23:03 AJaeger: oh good! thanks :) 21:23:13 jrobinson? 21:23:35 Hi, So the command conversions have happened at a good pace 21:24:08 jrobinson +1 yeah 21:24:14 :) 21:24:17 The User Guide appear to be mostly complete, with the condition that the trove and manila teams do not have openstack functionality based on the trove and manila commands yet. 21:24:36 great! 21:24:58 The admin guide I have started checking through the files. I suspect there is more to convert, but I'm feeling confident it will be ready. 21:25:06 #action jrobinson to follow up manila and trove command status 21:25:12 awesome, thanks jrobinson 21:25:24 One file has commands that added that were not ready yet however, 21:25:24 is there anything else on speciality teams before we move on? 21:25:37 #link https://bugs.launchpad.net/openstack-manuals/+bug/1649611 21:25:37 Launchpad bug 1649611 in openstack-manuals "Unimpletemed --fixed-ad functionality mentioned in Manage IP addresses in End User Guide" [Medium,Confirmed] - Assigned to Joseph Robinson (joseph-r-email) 21:25:47 I'm going to patch this today. 21:25:55 ah, ok 21:25:56 np 21:26:10 thanks again to Alex for the link. 21:26:17 I think that's all for now :) 21:26:23 cool, thanks jrobinson 21:26:25 is there anything else on speciality teams before we move on? 21:26:26 Thanks again 21:27:03 #topic Countdown to release: 21:27:15 #info 40 days 21:27:36 i'm at a conference next week, but will begin kicking off all the release tasks 21:27:52 i knew this release would come around fast, but i still wasn't quite ready ;) 21:28:21 so, start thinking about helping out with general updates, install guide testing, etc 21:28:25 #topic PTG Atlanta Feb 20-24 2017 21:28:30 #link http://www.openstack.org/ptg Event info 21:28:34 #link https://pikeptg.eventbrite.com/ Tickets 21:28:38 Docs is on Monday/Tuesday 21:28:51 we'll be rebranding as Docs/i18n 21:29:03 nice 21:29:11 so translators are welcome, as well as docs people 21:29:11 Yey~ :) 21:29:15 as long as we don't write docs in German or Japanese ;) 21:29:21 AJaeger hee 21:29:26 haha 21:29:28 ianychoi: i haven't checked, has that change gone through? 21:29:39 #link https://wiki.openstack.org/wiki/PTG/Pike/Etherpads 21:29:50 AJaeger: nobody wants to read anything i've written in something other than english, let me tell you ;) 21:30:01 although australian could be considered a language other than english sometimes ;) 21:30:02 The change was committed here first and I have not checked main page yet (but will be changed within a few days) 21:30:12 awesome! thanks ianychoi :) 21:31:02 We need to start to gather discussion topics on Etherpad 21:31:07 just a reminder, too, i won't be planning the PTG events, that will up to our new PTL 21:31:17 yes, i'll ping asettle and katomo and get that rolling 21:31:46 #topic Boston Summit 21:31:54 #info CFP is now open #link https://www.openstack.org/summit/boston-2017/call-for-presentations/ 21:31:54 loquacities, +1 :) 21:32:10 #topic Voting 21:32:20 #info PTL nominations open week of 23 Jan. 21:32:26 #info PTL Voting in first week of Feb. 21:32:59 #info Foundation voting is still open. 21:33:24 and katomo is up for foundation board, so make sure you go vote 21:33:36 #topic Open discussion 21:33:39 anything else? 21:34:21 docs.o.o is served by OpenStack CI and looks fine IMHO 21:34:28 oh! thanks for reminding me :) 21:34:36 nice work AJaeger and infra team! 21:34:37 yes, it looks good to me :D 21:34:37 OpenStack infra I mean... 21:34:53 AJaeger do you need any more work done on the links? 21:34:54 i was impressed how quickly that all happened 21:34:58 I have a larger patch up in preparation for Sphinx 1.5 - https://review.openstack.org/#/c/419053/ - reviews are welcome 21:35:06 AJaeger or have you logged bugs against projects? 21:35:22 annegentle: see my last email to the docs mailing list. Anybody going through that and filing bugs would be cool 21:35:33 AJaeger yeah, saw the note, wasn't sure of next steps 21:35:41 AJaeger to me, seems like bug logging would be a good next step 21:35:42 annegentle: only filed bugs against ansible to keep asettle busy ;) They were number 1 or 2 with dead links 21:35:47 AJaeger hee 21:35:53 lol 21:35:53 AJaeger she "wins!" 21:36:08 so, if anybody wants to report bugs: Please do. 21:36:17 AJaeger what was the count on that JSON file? 21:36:24 160 lines 21:36:27 I'll take the projects that start with N 21:36:53 #info All: log bugs for the broken links in the JSON file AJaeger sent to the ML 21:37:07 #action annegentle to log broken links bugs for projects that start with n 21:37:16 #info ansible bug links already logged 21:38:24 For buliding PDFs, I am seeing some latex_elements option in conf.py to apply styles, especially using 'presemble'. 21:38:25 Using 'presemble' ( http://www.sphinx-doc.org/en/1.5.1/latex.html ) looks nice. 21:38:25 I will try to speed up to apply a theme within O cycle. 21:38:36 loquacities do you have a target date when you need feedback from teams on Ocata install process? 21:39:07 we'll probably be freezing the guides in the next couple of weeks 21:39:19 or do you mean for testing? 21:39:33 testing will run right up until we publish 21:39:41 for testing to make sure project guides accurately reflect changes in Ocata 21:39:46 ok 21:39:47 cool 21:39:57 keep an eye on the docs ML for updates 21:40:05 will do - thanks! 21:40:07 np 21:40:11 right now we have no links to the pdfs - or have we now? 21:40:32 AJaeger not that I've seen, other than in the www-index, yah? 21:40:49 exactly - but before we do that, we should review that we like the style. 21:41:05 style of the PDF I mean 21:41:14 AJaeger yeah, I agree 21:41:25 AJaeger and then a UX review of how users get to the PDFs 21:41:40 #link http://docs-draft.openstack.org/53/419053/7/check/gate-openstack-manuals-tox-doc-publish-checkbuild/ae3c2d8//publish-docs/ 21:41:52 ianychoi though I can't recall if the spec mentions UX review :) only the PDF output review in the spec 21:42:01 ianychoi so I might be jumping further than meant 21:42:17 you can download pdf like http://docs.openstack.org/ha-guide/HAGuide.pdf 21:42:34 oh, btw. fungi will soon get us https set up for docs.o.o and developer.o.o 21:42:41 oh, cool 21:42:50 actually, i need a web dev 21:43:00 for the install guide landing page 21:43:03 who should i talk to? 21:43:28 annegentle, UX review is so important! But.. I need to do more study on applying themes with Sphinx + Latex 21:43:35 fungi yay yay yay omg yay 21:43:43 lol 21:43:52 ianychoi how would you like input on the PDF output? (oh I crack myself up) 21:43:59 annegentle: is my daughter using your keyboard? ;) 21:44:00 yep, just need to get around to issuing the cert 21:44:23 i have a bunch i need to renew in the coming week and will lump that one in with them 21:44:28 fungi Thanks, sweet. 21:44:37 fungi, no pressure ;) thanks 21:44:53 my pleasure, as always 21:45:14 annegentle, haha :) Then it might be better for me to open Etherpad for review items 21:45:33 ianychoi these are minor, minor 21:46:07 annegentle, but sometimes significant with minor :) 21:46:17 ianychoi ha you're preaching to the choir 21:46:53 annegentle, huk... :) 21:47:06 * AJaeger needs to leave now and waves good-bye 21:47:17 Good night 21:47:18 AJaeger cya! 21:47:32 cya AJaeger o/ 21:47:44 looks like we might be done here? 21:47:55 just because I sign off? ;) 21:48:05 AJaeger ha ha 21:48:08 AJaeger ye 21:48:12 AJaeger yes 21:48:12 you're the life of the party, AJaeger! 21:48:16 Haha 21:48:35 ok, thanks everyone 21:48:36 o/ 21:48:40 o/ 21:48:41 #endmeeting