03:09:57 <loquacities> #startmeeting docteam
03:09:58 <openstack> Meeting started Wed Apr 30 03:09:57 2014 UTC and is due to finish in 60 minutes.  The chair is loquacities. Information about MeetBot at http://wiki.debian.org/MeetBot.
03:09:59 <openstack> Useful Commands: #action #agreed #help #info #idea #link #topic #startvote.
03:10:01 <openstack> The meeting name has been set to 'docteam'
03:10:21 <slong> loquacities: good afternoon :)
03:10:24 <loquacities> hello!
03:10:30 <loquacities> thanks for reminding me slong :)
03:10:40 <slong> deepti was on it!
03:10:41 <loquacities> welcome Sam-I-Am
03:10:46 <Sam-I-Am> hello
03:10:48 <dnavale> hi loquacities
03:10:49 <loquacities> nice work dnavale :)
03:10:57 <slong> man, do you ever sleep, Sam-I-Am?
03:11:30 <Sam-I-Am> slong: sometimes. perhaps i'm just part of the cloud.
03:11:30 <loquacities> i think my little team is all off having lunch and stuff
03:11:34 <loquacities> Sam-I-Am: you've been working too hard clearly :P
03:11:49 <slong> Sam-I-Am: definitely.
03:12:01 <Sam-I-Am> loquacities: naahhh :P
03:12:05 <brucer> Hi there
03:12:10 <Sam-I-Am> its calmed down a lot since release
03:12:13 <loquacities> hey brucer
03:12:25 <loquacities> #topic Action items from the last meeting
03:12:36 <loquacities> annegentle to send post about doc tools requirements to openstack-docs mailing list
03:12:41 <loquacities> i think she did that, yes?
03:13:18 <loquacities> everyone look at the requirements listing in http://justwriteclick.com/2014/04/10/tearing-down-obstacles-to-openstack-documentation-contributions/ and give feedback on the openstack-docs mailing list
03:13:55 <loquacities> has everyone done the survey?
03:14:08 <Sam-I-Am> i have
03:14:15 <loquacities> yay
03:14:43 <slong> thought only operators were asked?
03:15:08 <slong> d.... wrong one. sorry, not yet.
03:15:09 <loquacities> "If you�ve contributed to OpenStack"
03:15:19 <Sam-I-Am> there's also a potential doc talk on 'patching the docs process' at the summit
03:15:30 <loquacities> excellent
03:15:34 <Sam-I-Am> which would include a variety of things
03:15:35 <loquacities> i'm sad i won't get there
03:15:43 <Sam-I-Am> whaaaaat????
03:15:49 <Sam-I-Am> -1 on that
03:15:49 <slong> loquacities: thought you'd be there?
03:15:54 <loquacities> nah, sorry
03:15:56 <loquacities> single parent, etc
03:16:06 <slong> Sam-I-Am: that talk is definitely on the schedule.
03:16:09 <Sam-I-Am> kids pack into luggage well
03:16:10 <loquacities> it's tough for me to go to the US more than once or twice a year
03:16:13 <slong> loquacities: bummer
03:16:16 <loquacities> not this one ;)
03:16:29 <slong> loquacities: would have been nice to share the jet lag.
03:16:35 <loquacities> yeah, too right
03:16:40 <loquacities> #topic Icehouse release
03:16:43 <Sam-I-Am> slong: you and fifield can share
03:17:08 <slong> he doesn't get jet lag anymore, is too seasoned.
03:17:13 <loquacities> so anne wanted to go through what went well/not so well about the release
03:17:19 <Sam-I-Am> wow, thats... amazing
03:17:35 <loquacities> is that really a thing?
03:17:40 <loquacities> can you *not* get jetlag?
03:17:55 <Sam-I-Am> i suppose if you can sleep anywhere at anytime its not an issue
03:18:02 <slong> have met such people. I've never been one myself.
03:18:13 <slong> NEVER sleep on planes, then die.
03:18:20 <loquacities> slong: +1
03:18:26 <Sam-I-Am> i dont travel outside of the US, so it doesnt affect me much
03:18:33 <brucer> sleep is for the weak
03:18:36 <slong> Anyhoo, we'll all do the survey now... Sam-I-Am, it's time.
03:18:52 <loquacities> what's that brucer? sleep for a week? yes please ;)
03:19:00 <martinlopes> lol
03:19:04 <brucer> :-)
03:19:06 <loquacities> so, highlights/lowlights of icehouse?
03:19:06 <Sam-I-Am> i need to find a place to travel to
03:19:14 <Sam-I-Am> loquacities: the install guide seems to work
03:19:21 <ddomingo> will do
03:19:23 <Sam-I-Am> not many bug reports, nothing serious at least
03:19:23 <loquacities> the install guide is a thing of beauty
03:19:34 <loquacities> excellent
03:19:37 <Sam-I-Am> i'm occasionally making fixes
03:19:55 <slong> loquacities: contributor numbers were up.
03:19:58 <Sam-I-Am> now in the off-season, i'm auditing it for lots of stuff we still need to do
03:20:01 <loquacities> oh great!
03:20:17 <Sam-I-Am> plenty of work before juno gets kicking
03:20:29 <loquacities> yeah, good idea to regroup now
03:20:42 <slong> Sam-I-Am: did the Install Guide already branch??
03:20:48 <Sam-I-Am> not seeing nearly as many issues in the support channel
03:20:50 <Sam-I-Am> slong: no
03:21:02 <Sam-I-Am> i think its going to branch just before the summit at the latest
03:21:05 <slong> tg, thought I'd come back as Rip Van...
03:21:10 <Sam-I-Am> we were waiting to see if there were any significant bugs
03:21:13 <slong> Good, have been trying to get bug fixes in.
03:21:59 <loquacities> #topic O'Reilly Ops Guide status
03:22:20 <loquacities> 14:22:26 <annegentle> With amazing publishing prowess, O'Reilly will be sending us an epub today or tomorrow for us to post
03:22:21 <loquacities> 14:22:38 <annegentle> I need to write a blog entry for OpenStack.org
03:22:33 <loquacities> 14:23:02 <annegentle> There will be copies at the Summit
03:22:40 <Sam-I-Am> i havent heard anything new on that
03:22:45 <Sam-I-Am> i need a copy though
03:22:47 <loquacities> ^^ c&p from the last US meeting
03:22:52 <loquacities> yeah, i'd love a copy too :)
03:23:01 <loquacities> slong: can you pick one up for me at summit? ;)
03:23:06 <Sam-I-Am> which reminds me, we need to work on the havana->icehouse upgrade process
03:23:19 <slong> Sure, will post it back...email me your address.
03:23:24 <loquacities> will do
03:23:28 <loquacities> thanks slong :)
03:23:31 <loquacities> Sam-I-Am: good point
03:23:31 * Sam-I-Am shudders at the thought
03:23:33 <slong> np
03:23:53 <slong> Bits have started to be added to that task.
03:23:58 <Sam-I-Am> i think we need to nail down the precise things we will test
03:24:14 <Sam-I-Am> too many permutations
03:24:20 <loquacities> agreed
03:24:34 <slong> Sam-I-Am: You're definitely the best person to do it :D
03:24:41 <loquacities> heh
03:24:43 * Sam-I-Am hides
03:24:43 <loquacities> +1
03:24:56 * Sam-I-Am -2's himself
03:25:07 <loquacities> you can't hide :P
03:25:13 <Sam-I-Am> we need more contributors!
03:25:13 <slong> not at all.
03:25:20 <Sam-I-Am> hopefully we can get more by improving the process
03:25:20 <loquacities> #topic Doc contribution survey - please post everywhere
03:25:24 <loquacities> we already mentioned that
03:25:26 <loquacities> moving on
03:25:34 <loquacities> #topic Doc tools news
03:26:04 <loquacities> 14:28:14 <annegentle> I noticed this week that the api-site wasn't building what I thought should be built on draft-docs.openstack so AJaeger is already addressing
03:26:15 <loquacities> 14:28:47 <annegentle> oh and dianefleming has requested a new release of the clouddocs-maven-plugin
03:26:15 <loquacities> 14:28:55 <annegentle> that'll get us the PDF links for the API references
03:26:22 <slong> tg for ajaeger
03:26:27 <loquacities> indeed
03:26:37 <loquacities> 14:29:37 <annegentle> yes we won't update the version for openstack-manuals pom.xml files
03:26:37 <loquacities> 14:29:46 <annegentle> just for api-site pom.xml
03:26:43 <loquacities> i think that's all the salient points
03:26:49 <loquacities> did anyone have anything to add to that?
03:27:37 <loquacities> #topic Summit doc track decisions
03:27:43 <loquacities> #link http://summit.openstack.org/cfp/topicstatus
03:27:53 <slong> I saw that Anne had pushed the topics
03:27:53 <loquacities> 14:36:17 <annegentle> that link shows how "oversubscribed" some of the projects are for track talks. We're fine at 5 proposed for 4 slots
03:28:55 <loquacities> 14:36:32 <annegentle> #link http://summit.openstack.org/
03:28:55 <loquacities> 14:36:48 <annegentle> Take a look at the Doc topics, any we should combine or further open up?
03:29:18 <Sam-I-Am> we couldnt come up with any good combination options at the last meeting
03:29:20 <loquacities> the docs talk all look pretty sane to me
03:29:28 <loquacities> yeah, it'd be hard to combine any of those, i think
03:29:35 <slong> Interesting though that it doesn't talk about the suite as a whole.
03:29:49 <slong> What's the next step, etc.
03:29:49 <Sam-I-Am> in what sense?
03:31:22 <slong> Sam-I-Am: Just meant that there's no overview design session
03:31:32 <Sam-I-Am> oh... hmmmmm
03:31:36 <loquacities> slong: i think the fact that there's so much to talk about makes it hard
03:31:44 <loquacities> forest, trees, etc
03:32:00 <slong> Yes, and yet a brainstorming about the next big step forward would be interesting.
03:32:19 <loquacities> i agree
03:32:20 <Sam-I-Am> slong: i wonder if that might be mentioned in patching the docs process
03:32:24 <Sam-I-Am> its kind of open
03:32:36 <loquacities> well, that's about the process itself, though, not the docs?
03:32:47 <slong> looks like it, doesn't look like suite design.
03:32:54 <Sam-I-Am> its about a lot of things
03:33:03 <slong> http://junodesignsummit.sched.org/event/ec58d8f3a8cb2a4779312e31b7473866#.U2BuzHWSyVc
03:33:33 <slong> Anyhoo, might hijack a lunch sometime.
03:34:03 <Sam-I-Am> i think i'm not understanding the idea of suite design
03:34:11 <Sam-I-Am> so you're talking about the kind of docs we produce?
03:34:31 <slong> Exactly. Are we hitting our audiences, what's missing, what could be combined. Etc.
03:34:39 <loquacities> delivery methods, too
03:34:44 <slong> yep
03:34:54 <loquacities> whether we should drop books, or write more, or merge some
03:34:58 <loquacities> etc
03:35:10 <Sam-I-Am> good point. well, there is supposedly a lunch in between our sessions
03:35:26 <slong> god, they'd better let me eat!
03:35:34 <slong> :D
03:35:45 <loquacities> #topic Installation guide
03:35:52 <loquacities> #link https://wiki.openstack.org/wiki/IceHouseDocTesting
03:36:02 <Sam-I-Am> lots of green
03:36:04 <loquacities> we've already mentioned this, but wanted to say well done to Sam-I-Am in particular
03:36:13 <Sam-I-Am> thanks!
03:36:14 <loquacities> green is nice :)
03:36:28 <Sam-I-Am> still plenty more to do... particularly around the "less popular" sections
03:36:35 <Sam-I-Am> optional components mainly
03:36:50 <Sam-I-Am> but right now, everyone should be able to follow it and at least launch a basic instance
03:36:51 <loquacities> there's always more to do :)
03:37:00 <loquacities> that's awesome :)
03:37:00 <Sam-I-Am> so much to do, so little time.
03:37:05 <Sam-I-Am> i need a full time install guide job
03:37:26 <loquacities> you need to find someone to hire you, Sam-I-Am!
03:37:34 <Sam-I-Am> tell me about it
03:38:04 <loquacities> #topic Open discussion
03:38:11 <Sam-I-Am> hopefully the audit will bring some of these things out
03:38:23 <Sam-I-Am> need more contributors!
03:38:27 <loquacities> so, i would like to mention that pycon au is on in brisbane in august
03:38:48 <loquacities> and i'd really like to get a doc sprint or something happening around the time that it's on
03:38:58 <Sam-I-Am> on which docs?
03:39:04 <brucer_meeting> on what?
03:39:08 <brucer_meeting> snap!
03:39:15 <loquacities> well, that's the question :P
03:39:24 <loquacities> i was thinking of making it a general "open source docs" thing
03:39:43 <loquacities> but i'm open to ideas
03:39:50 <slong> Narrow it down and I'm there :)
03:39:59 <loquacities> to what do you think?
03:40:04 <slong> Perhaps something will come out of Summit.
03:40:15 <Sam-I-Am> slong: thats what i'm thinking
03:40:15 <loquacities> true, but it's cutting it fine
03:40:22 <slong> True.
03:40:34 <Sam-I-Am> maybe improve the networking stuff? :P
03:40:39 <loquacities> that would be nice
03:40:54 <Sam-I-Am> more example configs, etc... maybe stemming from the install guide archs
03:41:13 <Sam-I-Am> there's a blueprint floating around for those things, but time... all about time.
03:41:25 <loquacities> Sam-I-Am: maybe this is the excuse you need to travel? ;)
03:41:29 <loquacities> brisbane is lovely this time of year!
03:41:29 <Sam-I-Am> updating the install guide kind of kicked my butt
03:41:30 <slong> Sam-I-Am: sounds good. What's the blueprint?
03:41:42 <Sam-I-Am> slong: hold on
03:42:24 <Sam-I-Am> https://blueprints.launchpad.net/openstack-manuals/+spec/improve-networking-cloud-admin-guide
03:42:50 <Sam-I-Am> https://blueprints.launchpad.net/openstack-manuals/+spec/create-networking-guide
03:42:53 <Sam-I-Am> those two mainly
03:43:06 <slong> ta
03:43:16 <loquacities> hrm, those could work
03:43:38 <Sam-I-Am> there's also the training manuals
03:43:45 <Sam-I-Am> those guys could use a bump
03:43:59 <loquacities> i've been pretty much ignoring them
03:44:12 <loquacities> i'm not sure what help they need at this point
03:44:15 <slong> I've never understood the training-to-docs relationship.
03:44:18 <slong> upstream...
03:44:19 <loquacities> same
03:44:36 <Sam-I-Am> sounds like they might reference the install guide for their labs, which is good.
03:44:46 <slong> definitely.
03:44:49 <Sam-I-Am> less duplication of stuff
03:45:24 <Sam-I-Am> i dont know much about that group
03:45:31 <loquacities> same
03:45:31 <slong> Sounded though like the training group was pretty insular.
03:45:40 <slong> Got that feel at the bootcamp.
03:46:08 <Sam-I-Am> i wonder if thats changing given the size of their group
03:46:15 <Sam-I-Am> and its not really an official project of sorts
03:46:38 <slong> What is the size of their group?
03:46:45 <Sam-I-Am> 3 maybe?
03:47:05 <loquacities> oh
03:47:46 <Sam-I-Am> i think pranav salunke runs it
03:47:55 <Sam-I-Am> also known as dguitarbite on here iirc
03:48:45 <brucer_meeting> it s maybe more a case of communicatins than being insular.
03:48:52 <loquacities> yeah, probably
03:48:55 <slong> Good to know.
03:48:57 <loquacities> or a bit of both
03:49:29 <loquacities> alright, any other business?
03:49:34 <loquacities> we have ten minutes left ...
03:49:46 <Sam-I-Am> not much from here
03:49:51 <slong> nope
03:49:54 <brucer_meeting> nope
03:49:58 <loquacities> excellent
03:50:00 <loquacities> thanks everyone :)
03:50:06 <loquacities> #endmeeting