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