14:06:12 #startmeeting docteam 14:06:13 Meeting started Wed Aug 26 14:06:12 2015 UTC and is due to finish in 60 minutes. The chair is annegentle. Information about MeetBot at http://wiki.debian.org/MeetBot. 14:06:14 Useful Commands: #action #agreed #help #info #idea #link #topic #startvote. 14:06:16 hi all, welcome 14:06:17 The meeting name has been set to 'docteam' 14:06:29 I'm starting the meeting for Shilla 14:06:37 Agenda is here: https://wiki.openstack.org/wiki/Meetings/DocTeamMeeting#Agenda_for_next_meeting 14:07:04 let's look at any action items from last time 14:07:41 Seeing none, I move we move on :) 14:07:45 HI annegentle 14:07:51 hey AJaeger 14:07:58 anyone else here, raise your hand for doc team meeting? 14:08:28 I'm more or less here 14:08:32 hi gpocentek ! 14:08:50 hey Andreas :) 14:08:56 hey gpocentek! 14:09:03 we'll take the more or less :) 14:09:14 hi Anne, ok :) 14:09:42 #topic #Liberty specs in review 14:09:46 I think there are two left 14:10:06 The API docs one with the updates for "narrative" or conceptual topics merged 14:10:20 #link http://specs.openstack.org/openstack/docs-specs/specs/liberty/api-site.html 14:11:00 Third party driver docs still has a task assignment,for purging 14:11:02 #link https://review.openstack.org/#/c/191041/ 14:11:44 And I think there's a fairly fresh one to improve the Arch Design Guide 14:11:47 The arch-design RST conversion spec merged 14:12:08 Oh I still see it with two +2s but no merge 14:12:14 #link https://review.openstack.org/#/c/216106/ 14:12:29 Ah, awaiting Shilla's approval 14:13:36 #info Arch Design doc updates spec awaiting Shilla's review and approval 14:13:50 next topic 14:13:52 #topic Speciality teams 14:13:58 Any report on HA Guide? 14:14:20 #info HA Guide - RST migration complete, need help with updating content. 14:14:21 Next team 14:14:32 Install Guides, anyone reporting? Looks like they had a calendar snafu. 14:14:50 HA guide team is not clear how to continue with publishing - keeping current content or publishing RST one. 14:15:15 #info Install Guides - RST migration complete, testing for Liberty now, content works for keystone, glance, nova, and neutron (but he didn't say which distro) 14:15:27 AJaeger: did the content change? 14:15:45 AJaeger: meaning, it's not updated enough to publish? 14:15:54 annegentle: on in small areas, so to me it looks like it's not worse than what we have ;) 14:16:13 But I got no response from the team in the last few days 14:16:18 AJaeger: ah ok 14:16:36 #action HA Guide team needs to determine whether to start publish RST version 14:17:01 Anyone here for Networking Guide team? 14:17:26 They meet on Fridays, not sure if they met last week. 14:17:31 hello! 14:17:33 sorry I'm late 14:17:37 hey ShillaSaebi! 14:17:47 Just going through specialty teams now, up to networking 14:17:52 awesome 14:18:01 Anyone here from security team? 14:18:03 hello 14:18:11 hey sicarie got any updates for Networking? 14:18:18 No, but I can speak to Security :) 14:18:22 sicarie: sounds good 14:18:30 I was at the ops mid cycle meetup and it was mentioned for people to go through the Networking guide and review it if possible 14:18:42 We completed the RST migration about two weeks ago (thanks again AJaeger!) 14:19:04 Right now we're scoping what we'd like to do for the next paper version - we'd like to get it updated before the Summit 14:19:16 sicarie: you and the team did the major work, I just pushed you over the edge ;) 14:19:33 And then there should be a discussion on how the paper version should be maintained - on what cadence 14:19:39 AJaeger, but they were great pushes! 14:19:40 sicarie: we currently do not build PDFs, somebody needs to evaluate this. 14:19:47 Yes 14:19:50 sicarie: right 14:20:02 Right now we're trying to determine if anything is 'missing' that woudl be critical from a security perspective 14:20:02 sicarie: there's rst2pdf and it worked locally - give it a try. 14:20:12 sicarie: so the team does want printed available on Lulu? 14:20:38 anngentle: If we don't, we need to take that option down 14:20:44 Though I'm not sure i've seen it since the RST migration 14:21:05 The current lulu copy is 1.0, which is ... very old and is now very inaccurate 14:21:09 AJaeger: if you do evaluate, you need the Lulu requirements for PDF. 14:21:12 AJaeger: let me dig them up 14:21:19 sicarie: I can take it down 14:21:28 annegentle: thanks! 14:21:35 annegentle: I won't have time to evaluate ;( 14:21:53 #action annegentle to remove PDF of Security Guide from lulu.com 14:22:03 I think that's the right way forward 14:22:28 and done 14:22:39 Anything else on security or networking? 14:22:47 Nope - just focusing on current bugs 14:22:53 How about User Guides - and Cloud Admin Guide 14:23:04 #info User Guides - Cloud Admin Guide RST migration complete, work starting on reorganisation. 14:23:34 We still have some old URLs... 14:23:57 AJaeger: with /content right? 14:24:06 annegentle: yeah ;( 14:24:07 #link http://docs.openstack.org/admin-guide-cloud/ 14:24:12 it's really beautiful though :) 14:24:18 AJaeger: and redirects are in place? 14:24:33 annegentle: redirects to index.html 14:24:46 not to single pages - each URL is different ;( 14:25:12 AJaeger: ah, right. 14:25:32 Ok anything else on user guides? 14:26:00 Ok onward to Ops Guide and Arch Design Guide 14:26:07 ok 14:26:15 #info Ops/Arch Guides - Arch Guide swarm was a success. Plans for reorganisation in Mitaka. 14:26:15 #Info Two specs have been drafted for the Architecture Design Guide: #link https://review.openstack.org/#/c/214949/ and #link https://review.openstack.org/#/c/216106/ 14:26:21 And that's the spec yup 14:26:26 ShillaSaebi: Lana asked for your approval 14:26:38 Ok I will make sure I take care of that today 14:26:48 The corresponding blueprints: #link https://blueprints.launchpad.net/openstack-manuals/+spec/archguide-mitaka-reorg  and #link https://blueprints.launchpad.net/openstack-manuals/+spec/archguide-mitaka-rst 14:26:56 thanks 14:27:26 Nice work on the swarm, I heard it was a great time and I'm so glad we have more cores on that side of the world 14:27:29 :) 14:27:39 for the Ops guide, we discussed having a doc day maybe 1 day after or before the next mid cycle meetup to have people update the guides 14:27:40 In the ops guide there are upgrade instructions. 14:28:09 Wanted to point to comments in https://bugs.launchpad.net/openstack-manuals/+bug/1486250 14:28:10 Launchpad bug 1486250 in openstack-manuals "Add upgrade path for Juno to Kilo" [Undecided,Won't fix] 14:28:20 intending to change the way we document upgrades 14:28:31 ok 14:28:39 Thought this is a good place to communicate that 14:28:55 Anything else on those? 14:29:13 ok 14:29:14 nope 14:29:44 ok 14:29:55 on to API docs 14:30:00 I sent out a status update last week 14:30:37 still looking for Python dev to help out? 14:30:40 devs* 14:30:44 #link http://lists.openstack.org/pipermail/openstack-dev/2015-August/072557.html 14:31:03 team by team there are joiners :) 14:31:21 ok I think I have someone in mind that may be able to help, will send them your way 14:31:22 another update is that there's a lot of activity on this thread about generating requests and responses 14:31:23 #link http://lists.openstack.org/pipermail/openstack-dev/2015-August/072743.html 14:32:15 Also, if you're interested in the Compute 2.1 api, see this etherpad 14:32:17 ##link https://etherpad.openstack.org/p/nova-v2.1-api-doc 14:32:25 ShillaSaebi: thanks :) 14:32:33 cool! 14:32:40 That's it for API docs 14:33:04 Anything on config ref? 14:33:08 gpocentek: any news? 14:33:21 annegentle: not much no :( 14:33:49 gpocentek: ok fair enough, no news may be good news :) 14:33:55 heh 14:34:02 I want to say "nothing is on fire" for the notes :) 14:34:11 thats a good thing 14:34:16 no complaints here! 14:34:22 #info Config Ref No news to report 14:34:33 Anyone here from training labs? 14:34:55 Pranav is working on setting up the new repository 14:34:56 Want to make sure you all know we have the training labs specialty team and looks like we'll also add the training guides specialty team 14:34:59 AJaeger: great 14:35:07 oh so they will be separate 14:35:13 #info training labs contact person is Pranav Salunke 14:35:26 ok good to know, I thought they were still going to be bundled into 1 14:35:34 and Majtaz will be the contact for training guides right? 14:35:45 #info training guides contact person is Matjaz Pancur 14:35:58 ShillaSaebi: yes for now 14:36:01 Should have an email to the list this week 14:36:09 Sean has stepped down from training guides 14:36:14 Give loquacities an action item ;) 14:36:15 so I think it's pretty well sorted! 14:36:24 cool 14:36:33 AJaeger: it's Matjaz's comm to make I believe 14:37:04 Ok any other specialty team reports or news? 14:37:18 ShillaSaebi: can I hand over the note taking and topic making? :) 14:37:29 ShillaSaebi: you can go through the rest of the agenda 14:37:31 sure thing, thanks a lot for stepping in today 14:37:37 np! 14:37:40 missing my exit set me back 20 minutes hah 14:37:50 we released openstack-doc-tools 0.30.0 and I have 0.30.1 to release: https://review.openstack.org/#/c/217028/ to fix Japanese Debian Install Guide 14:38:08 openstackdocstheme 1.2.1 was released as well 14:38:42 nice 14:38:59 #topic Countdown to Liberty 14:39:27 #info We are getting closer to the summit #link http://www.timeanddate.com/countdown/launch?iso=20151015T00&p0=1440&msg=OpenStack+Liberty+Launch+Date&font=hand 14:39:31 annegentle: I think only you as starter of the meeting can use the magic #topic etc. 14:39:44 ahh 14:39:56 annegentle: Im here 14:39:56 #topic Countdown to Liberty! 14:40:01 Now with more exclamation points! 14:40:05 ahhhh the torch is handed back 14:40:06 hey dbite! 14:40:09 hi dbite 14:40:18 hello 14:40:20 anything to report? 14:41:05 We have decided to have two meetings every alternating Thrus, I will announce it in the ML, some part of repo migration is done, some is remaining. 14:41:15 #info 46 days until liberty release 14:41:30 excellent 14:42:02 time is flying by 14:42:03 #info training labs will have meetings alternating Thursdays, look for ML post with details. Migration nearly complete, work remains. 14:42:07 #link http://www.timeanddate.com/countdown/launch?iso=20151015T00&p0=1440&msg=OpenStack+Liberty+Launch+Date&font=hand 14:42:11 I know, crazy. 14:42:21 Today people should find out if their Summit talks are accepted 14:42:27 annegentle: training labs is renamed as OpenStack Labs too. 14:42:28 great, looking forward to it! 14:44:11 #link https://www.openstack.org/summit/tokyo-2015/tokyo-and-travel/#visa 14:44:24 dbite, annegentle : Can you really name it "OpenSTack Labs" ? I thought it needs offiical blessing by the foundation 14:44:30 annegentle: Great, everyone I know is eager to hear if they were picked 14:44:46 AJaeger: dbite: we discussed in their meeting this week 14:44:56 dbite: using openstack in the repo name isn't needed 14:45:05 and, using OpenStack is a trademark and requires brand permission 14:45:15 dbite: I think you had a poor net connection but can read the logs 14:45:52 https://review.openstack.org/#/c/201160/ 14:46:47 dbite: hope that helps 14:46:52 naming, it's tough :) 14:48:34 Any one need help with ATC passes? Another round will go out. 14:48:46 That's it for Liberty release and Summit news I believe. 14:48:59 #topic APAC Meetups 14:49:09 Thanks to Suyog for organizing the swarm! And to the contributors 14:49:17 #topic Spotlight bugs 14:49:26 Look for these in the weekly What's up doc? 14:49:45 #link https://bugs.launchpad.net/openstack-manuals/+bug/1257018 14:49:47 still unassigned 14:49:51 Sorry, I lost connection for a bit. Ok, I will remove the name openstack and just keep it labs then. WIll need to edit the spec too. 14:49:52 Launchpad bug 1257018 in openstack-manuals "VPNaaS isn't documented in cloud admin" [Medium,Confirmed] 14:49:55 dbite: thanks 14:50:09 #link https://bugs.launchpad.net/openstack-manuals/+bug/1257656 14:50:11 Launchpad bug 1257656 in openstack-manuals " VMware: add support for VM diagnostics" [Medium,Confirmed] 14:50:26 This one has an assignee, woo! 14:50:26 #link https://bugs.launchpad.net/openstack-manuals/+bug/1261969 14:50:27 Launchpad bug 1261969 in openstack-manuals "Document nova server package (WAS: Enable remote debugging for nova)" [Low,Confirmed] - Assigned to Atsushi SAKAI (sakaia) 14:50:33 #topic Open discussion 14:50:40 want to be sure to leave plenty of time for discussion if there's anything 14:50:57 You all know stackforge is retiring, right? 14:52:12 annegentle: better say: stackforge namespace is retiring. 14:52:36 repos can be created in openstack namespace with some rules like stackforge today 14:52:41 s/some/same/ 14:53:27 I have a weird question, not sure if this is the right place, but is there HP in the license name of setup.py's? I was under the impression that all the licenses should have openStack Foundation http://git.openstack.org/cgit/openstack/openstack-manuals/tree/doc/contributor-guide/setup.py 14:53:42 AJaeger: Is that being planned or just something that could happen? 14:54:23 amandap: already announced, read the posts on openstack-dev by James Blair 14:59:19 time to close the meeting? 15:01:29 annegentle: ? 15:01:43 Seconded 15:02:10 Helimaniac: seems we lost our chair, I'm sorry ;( 15:02:40 #endmeeting