00:33:43 <loquacities> #startmeeting docteam 00:33:43 <openstack> Meeting started Wed Aug 5 00:33:43 2015 UTC and is due to finish in 60 minutes. The chair is loquacities. Information about MeetBot at http://wiki.debian.org/MeetBot. 00:33:44 <openstack> Useful Commands: #action #agreed #help #info #idea #link #topic #startvote. 00:33:46 <openstack> The meeting name has been set to 'docteam' 00:34:07 <loquacities> #topic Action items from the last meeting 00:34:36 <loquacities> i can't see any action items we should be following up on here 00:34:49 <loquacities> hi dnavale :) 00:35:03 <loquacities> #topic Liberty specs in review #link https://review.openstack.org/#/q/status:open+project:openstack/docs-specs,n,z 00:35:14 <loquacities> our list of specs is rapidly dwindling, which is good 00:35:22 <loquacities> #link https://review.openstack.org/#/c/191041/ (Third Party driver docs - requires discussion) 00:35:30 <JRobinson__> yes, m summit is about 3 months out 00:35:57 <loquacities> we haven't had any action on that third party spec for a while, i might need to send some emails on that 00:36:08 <loquacities> #link https://review.openstack.org/#/c/191077/ (Install Guide Liberty update - WIP) 00:36:45 <loquacities> that install guide spec should be more or less ready to merge now 00:36:54 <loquacities> any questions on specs? 00:37:31 <loquacities> right, moving on 00:37:34 <JRobinson__> I can't think of any 00:37:40 <loquacities> #topic Speciality teams: #link https://wiki.openstack.org/wiki/Documentation/SpecialityTeams 00:37:50 <loquacities> #info HA Guide - RST migration complete, need help with updating content. 00:37:56 <loquacities> #info Install Guides - RST migration nearly complete, testing to begin shortly. 00:38:03 <loquacities> great work on the install guide sprint, there 00:38:16 <loquacities> i'm gobsmacked that we got so much done in such a short period of time 00:38:28 <loquacities> #info Networking Guide - Test & review for Liberty updates. Need to audit content in devref. 00:38:37 <loquacities> #info Security Guide - RST conversion started, sign up here: #link https://etherpad.openstack.org/p/sec-guide-rst 00:38:52 <loquacities> if you're still looking for RST conversion work, the security guide is probably the best place to be right now 00:39:06 <loquacities> #info User Guides - Cloud Admin Guide RST migration complete, need to start work on reorganisation. 00:39:26 <JRobinson__> ^some good news 00:39:33 <loquacities> indeed :) 00:39:42 <JRobinson__> The last patch for rst conversion was merged last night/today 00:39:50 <loquacities> oh neat! well done :) 00:40:15 <loquacities> #info Ops/Arch Guides - Arch Guide swarm coming up. #link https://wiki.openstack.org/wiki/Documentation/OpsGuide 00:40:24 <suyog> yay! 00:40:28 <loquacities> #info API docs - Spec is now merged! #link https://wiki.openstack.org/wiki/Documentation/API 00:40:35 <JRobinson__> #info need to investigate switching from the .xml version to the .rst version, and complete final reviews to double check on any leftover files to convernt 00:40:59 <loquacities> #info Config Ref - New speciality team! Thanks Guavain #link https://wiki.openstack.org/wiki/Documentation/ConfigRef 00:41:11 <loquacities> JRobinson__: yep, i've got a note here to do that today for you 00:41:29 <JRobinson__> loquacities, thank you 00:41:35 <loquacities> np 00:41:47 <loquacities> anything else on speciality teams? 00:42:42 <loquacities> ok, moving on 00:42:50 <loquacities> #topic Doc tools update: 00:43:07 <loquacities> not much to say here really, except we're preparing to update the sphinx theme soon 00:43:19 <loquacities> #info new RST theme ready to be released soon 00:43:58 <loquacities> we've added a little toc nav in the left bar, and added prev/next buttons at the bottom of the page 00:44:16 <loquacities> any questions on tools? 00:44:58 <loquacities> is anyone still awake? ;) 00:45:20 <JRobinson__> more navigation is always good. 00:45:35 <loquacities> yeah, adding the toc nav in is great 00:45:53 <loquacities> it's not as pretty as we would like at this point, but it's a starting point 00:46:00 <loquacities> ok, moving on 00:46:07 <loquacities> #topic Licencing 00:46:15 <loquacities> #info Lana and Anne are consulting with legal on this 00:46:37 <loquacities> Anne and I had a meeting with legal this morning, and the answer to the question really is: 'it's complicated' 00:46:52 <loquacities> basically, though, everything should be CC-by 00:47:11 <loquacities> so we'll have a couple of small changes going through to fix some obvious errors there 00:47:30 <adahms> Interesting - what are some of the considerations, if I may? 00:47:47 <loquacities> so openstack licences code under apache 2.0 00:47:56 <loquacities> but docs are supposed to be all cc-by 00:48:11 <adahms> Ah, makes sense 00:48:13 <loquacities> because our docs *contain* code, though, it gets complicated 00:48:23 <loquacities> which is why you see a combination of cc-by and apache on our docs 00:48:25 <katomo> Ahh 00:49:12 <adahms> Hmm 00:49:31 <loquacities> i'm trying to find a link, sorry, bear with me 00:49:44 <adahms> That's a tricky one - hard to tell when a piece of code has been added and update the licence accordingly as well, I imagine 00:49:58 <loquacities> yeah, there's also inconsistency all over the place 00:50:06 <loquacities> and then there's theme issues to consider as well 00:50:39 <loquacities> ugh, this link is eluding me 00:50:49 <katomo> #link https://review.openstack.org/#/c/209276/ 00:50:59 <katomo> Fix: cc-by-sa -> cc-by 00:51:05 <loquacities> anyway, there's a few books which are currently listed as apache *only* which is clearly incorrect 00:51:22 <loquacities> katomo: yes, there's also two books that say cc-by-sa, which is also clearly incorrect 00:51:29 <bmoss> https://wiki.openstack.org/wiki/Documentation/ContentSpecs#Licenses 00:51:34 <loquacities> so that patch changes the cc-by-sa issue 00:51:45 <loquacities> bmoss: nailed it, thanks :) 00:51:54 <bmoss> np 00:51:54 <loquacities> #link https://wiki.openstack.org/wiki/Documentation/ContentSpecs#Licenses 00:52:03 <loquacities> i had it open earlier and lost it in my sea of tabs 00:52:33 <loquacities> so, of those three apache-only books, two of them are about to be republished as RST 00:52:42 <loquacities> when that happens, the theme will update the licence to cc-by 00:52:48 <loquacities> so we don't need to change anything there 00:53:08 <loquacities> the config ref is a weird one, mostly because it's almost completely autogenned from code, so apache isn't incorrect 00:54:23 <loquacities> anyway, any other questions on licencing? 00:55:02 <katomo> none. very complicated :) 00:55:06 <loquacities> it is 00:55:23 <loquacities> also: our legal advisor lisa is *extraordinarily* patient 00:55:30 <loquacities> i asked a lot of 101 questions this morning ;) 00:55:37 <loquacities> ok, let's move on 00:55:41 <loquacities> #topic APAC Meetups 00:55:51 <loquacities> i believe this is our last APAC meeting before the docs swarm 00:56:08 <JRobinson__> That's right, one week away from the swarm. 00:56:14 <loquacities> i can also announce that we have the openstack foundation on the hook for providing pizza 00:56:34 <bmoss> sweet 00:56:40 <loquacities> and i have rock the docs stickers, and a bunch of rackspace swag coming 00:56:46 <JRobinson__> good news :) 00:56:49 <adahms> :o 00:56:58 <adahms> Sounds swagtastic 00:57:21 <loquacities> we were also talking about doing an informal 'meet for pancakes' breakfast on the friday morning, too, for anyone who is interested in doing that 00:57:29 <loquacities> i might send email about that later today 00:57:40 <bmoss> If you're planning on coming to the swarm, please RSVP at the Meetup page: http://www.meetup.com/Australian-OpenStack-User-Group/events/224394774/ 00:57:42 <loquacities> suyog: maybe we could put a post on the swarm site about that? 00:57:55 <loquacities> bmoss: can you repeat that with #info? 00:58:06 <bmoss> #info If you're planning on coming to the swarm, please RSVP at the Meetup page: http://www.meetup.com/Australian-OpenStack-User-Group/events/224394774/ 00:58:16 <loquacities> ta :) 00:58:24 <loquacities> i see 8 RSVPs! already! 00:58:26 <loquacities> \o/ 00:58:38 <bmoss> better order lots of pizza 00:58:45 <loquacities> i'll say 00:59:12 <loquacities> ok, final point on the agenda: 00:59:15 <loquacities> #topic Spotlight bugs: 00:59:28 <loquacities> there's a couple of easy looking ones in this week 00:59:34 <loquacities> #link https://bugs.launchpad.net/openstack-manuals/+bug/1257018 VPNaaS isn't documented in cloud admin 00:59:34 <openstack> Launchpad bug 1257018 in openstack-manuals "VPNaaS isn't documented in cloud admin" [Medium,Confirmed] 00:59:35 <uvirtbot> Launchpad bug 1257018 in openstack-manuals "VPNaaS isn't documented in cloud admin" [Medium,Confirmed] https://launchpad.net/bugs/1257018 00:59:36 <uvirtbot> Launchpad bug 1257018 in openstack-manuals "VPNaaS isn't documented in cloud admin" [Medium,Confirmed] 00:59:40 <loquacities> #link https://bugs.launchpad.net/openstack-manuals/+bug/1257656 VMware: add support for VM diagnostics 00:59:41 <openstack> Launchpad bug 1257656 in openstack-manuals " VMware: add support for VM diagnostics" [Medium,Confirmed] 00:59:50 <loquacities> #link https://bugs.launchpad.net/openstack-manuals/+bug/1261969 Document nova server package 00:59:51 <suyog> Sorry, got distracted a bit. \o/ for everything above! 00:59:51 <openstack> Launchpad bug 1261969 in openstack-manuals "Document nova server package (WAS: Enable remote debugging for nova)" [Low,Confirmed] 00:59:57 <uvirtbot> Launchpad bug 1257656 in openstack-manuals "VMware: add support for VM diagnostics" [Medium,Confirmed] 00:59:58 <uvirtbot> Launchpad bug 1257656 in openstack-manuals "VMware: add support for VM diagnostics" [Medium,Confirmed] https://launchpad.net/bugs/1257656 00:59:59 <uvirtbot> Launchpad bug 1261969 in openstack-manuals "Document nova server package (WAS: Enable remote debugging for nova)" [Low,Confirmed] https://launchpad.net/bugs/1261969 00:59:59 <loquacities> damn echo chamber 01:00:01 <uvirtbot> Launchpad bug 1261969 in openstack-manuals "Document nova server package (WAS: Enable remote debugging for nova)" [Low,Confirmed] 01:00:36 <loquacities> #topic Open discussion 01:00:43 <loquacities> over to you guys :) 01:01:01 <bmoss> I've just put up a blueprint for the Arch Guide so we have it for the swarm 01:01:06 <bmoss> #link https://blueprints.launchpad.net/openstack-manuals/+spec/arch-guide-improvements 01:01:11 <suyog> Cool! 01:01:13 <loquacities> oh cool, thanks :) 01:01:16 <bmoss> I'll get a spec up presently 01:01:17 <loquacities> i missed that 01:01:46 <loquacities> once you've got your spec up i'll approve the bp for you 01:01:51 <bmoss> cool, thanks 01:01:54 <loquacities> np 01:02:20 <loquacities> anything else? 01:02:30 <loquacities> or can i give you 28 mins of your day back? 01:02:46 <bmoss> 28 minutes sounds good 01:02:49 <loquacities> awesome 01:02:51 <loquacities> it's yours 01:02:55 <loquacities> thanks for coming everyone :) 01:02:55 <bmoss> woohoo! 01:03:02 <bmoss> cheers 01:03:09 <suyog> thanks, loquacities! 01:03:17 <katomo> thanks 01:03:25 <loquacities> #endmeeting