13:10:32 <fifieldt_> #startmeeting Doc Team Meeting
13:10:33 <openstack> Meeting started Tue Aug 13 13:10:32 2013 UTC and is due to finish in 60 minutes.  The chair is fifieldt_. Information about MeetBot at http://wiki.debian.org/MeetBot.
13:10:34 <sgordon> yeah
13:10:34 <koolhead17> ah. good to see RH putting folks for doc too :)
13:10:35 <openstack> Useful Commands: #action #agreed #help #info #idea #link #topic #startvote.
13:10:38 <openstack> The meeting name has been set to 'doc_team_meeting'
13:10:46 <fifieldt_> yes, koolhead17 it's super awesome
13:10:49 <fifieldt_> hi also to dcramer_
13:11:09 <fifieldt_> #topic Action Items from the last meeting
13:11:19 <fifieldt_> let's get the boring stuff out of the way
13:11:27 <fifieldt_> these can be found at
13:11:28 <fifieldt_> #link http://eavesdrop.openstack.org/meetings/doc_team_meeting/2013/doc_team_meeting.2013-07-09-13.01.html
13:11:38 <fifieldt_> #1    cyeoh to study openstack/compute-api for the v2 docs
13:11:46 <fifieldt_> cyeoh, did you have a chance to look into that?
13:12:08 <cyeoh> cyeoh: so Kersten Richter has been looking at what is needed
13:12:24 <cyeoh> I've been spending some time trying to work out how we can automate the process from test_api_samples in nova
13:12:50 <fifieldt_> #info  Kersten Richter has been looking into api v2 docs
13:12:53 <cyeoh> to produce enough information so we can generate what is needed for openstack/compute-api through a script (mostly)
13:13:13 <fifieldt_> #info cyeoh is still looking at automatically generating openstack/compute-api through a script
13:13:15 <roadnick> ceyoh, I didn't have a chance to get with you before I went out for shoulder surgery, do you still need to get with me for WADL help on that?
13:13:16 <fifieldt_> cool, that's great
13:13:53 <cyeoh> roadnick: I think Kersten could probably do with a hand getting up to speed with things
13:14:06 <annegentle> hey sorry I'm late!
13:14:09 <fifieldt_> #action roadnick to meet with Kersten to help through the WADL journey
13:14:10 <cyeoh> The nova side review is here: https://review.openstack.org/#/c/40169/
13:14:13 <fifieldt_> hi annegentle
13:14:14 <koolhead17> annegentle, np :)
13:14:20 <fifieldt_> we're just looking at action items
13:14:22 <fifieldt_> 'just at number 1
13:14:29 <roadnick> Hi, annegentle
13:14:29 <fifieldt_> you have the con!
13:14:38 <slong> hi annegentle :)
13:14:40 <annegentle> ha
13:14:48 <annegentle> had to call for a dr appt for a kiddo, online now
13:14:56 <roadnick> Ceyoh, can you have her email me to set up a meeting, and do you have my email?
13:14:57 <cyeoh> roadnick: still at the stage of trying to work out if we can do it, but in the meantime generating api samples anyway for V3 as we'll need them in the end.
13:14:59 <EmilienM> annegentle: good morning :)
13:15:15 <annegentle> roadnick: how's your shoulder?
13:15:21 <cyeoh> roadnick: no, what's your email address? I'll forward it on to her
13:15:38 <roadnick> nchase@mirantis.com
13:15:39 <annegentle> #topic Action items from last meeting
13:15:45 <cyeoh> roadnick: thx!
13:16:05 <roadnick> painful, thanks, annegentle; at the "sick of being sick, have to be careful not to overdo it" stage :(
13:16:20 <annegentle> roadnick: oh I bet!
13:16:36 <annegentle> Ok, cyeoh to study openstack/compute-api for the v2 docs was from last month, how'd that go?
13:16:53 <cyeoh> annegentle: I've passed most of it off to Kersten
13:17:19 <annegentle> heh ok old news, reading scrollback more carefully
13:17:31 <cyeoh> I'm doing a bit on the Nova side to generate the api samples, and experimenting with also generating some metadata files which is (hopefully) enough to get a script to generate most of the doc
13:17:41 <annegentle> sarob's not around I guess? He was going to get cyeoh in touch with someone
13:18:15 <annegentle> I had asked Kersten to come to a Monday office hours and/or the boot camp, haven't heard from her though.
13:18:42 <cyeoh> annegentle: unfortunately I think it's pretty unlikely she'd be able to get travel approval for the boot camp :-( But she is trying
13:18:42 <annegentle> cyeoh: does it make sense for her to work with someone else or continue to work with me?
13:18:52 <annegentle> cyeoh: ok, good to know
13:19:29 <cyeoh> annegentle: she's still getting up to speed with it all. I'm meeting with her in a couple of days so will get an update then
13:19:38 <annegentle> cyeoh: ok
13:19:48 <annegentle> cyeoh: it's kind of a steep onramp
13:20:07 <annegentle> cyeoh: so I'm happy to help, and Diane's emailed her too
13:20:15 <annegentle> cyeoh: just don't want her to get mixed messaging from a bunch of us
13:20:25 <cyeoh> Thanks for all the help! yea, I very much doubt we're going to make Havana, but hopefully not too long after...
13:20:56 <annegentle> cyeoh: well, I think the doc should come as soon as possible
13:21:31 <cyeoh> annegentle: yea, its definitely a priority for us. Getting everything merged on the Nova side (api samples) is already looking pretty tight though
13:22:13 <annegentle> cyeoh: okay, good. Just didn't want to de-emphasize it even if v3 is "experimental" folks will be trying it out. It's what they do. :)
13:22:15 <annegentle> ok, next action was for me to find if maven plugin supports sets. It "Just Works" (tm) so that's good.
13:22:26 <fifieldt_> :D
13:22:31 <roadnick> great news
13:22:39 <annegentle> another action was anne to draft a Mission Statement for Documentation and send to docs mailing list. Done.
13:23:00 <annegentle> I haven't yet floated the Project Doc Lead idea... I have identified some people though so I might just reach out to individuals. Thoughts?
13:23:22 * fifieldt_ would like to see what that is written down :)
13:23:31 <koolhead17> :P
13:23:49 <annegentle> fifieldt_: yeah we need a matrix of projects and peeps
13:24:01 <roadnick> agreed
13:24:02 <annegentle> koolhead17: you up for starting a wiki page with candidates for doc leads?
13:24:09 <slong> that would be good.
13:24:18 <fifieldt_> annegentle, as in what a "project doc lead" is
13:24:28 <koolhead17> annegentle, sure. do we have many candidates in race? :)
13:24:33 <annegentle> fifieldt_: it was sarob's idea, let me dig up
13:24:48 <koolhead17> i thougth we already selected you for that :D
13:25:01 <roadnick> The project doc lead was ...
13:25:17 <roadnick> the idea that each project will have one person who's a "liasion" for the docs for that project
13:25:37 <annegentle> #link https://wiki.openstack.org/wiki/Documentation/ProjectDocLeads
13:25:37 <roadnick> for example we'd have one person at Mirantis who's the "go-to" person for info on Savanna docs
13:25:40 <koolhead17> roadnick, ahaan. makes sense
13:25:45 <koolhead17> happy to see its happening
13:25:53 <koolhead17> annegentle, hi5
13:26:05 <annegentle> I like the liaison idea for bug triage etc
13:26:14 <koolhead17> was asking the same longtime back if you remember :D
13:26:39 <fifieldt_> I think that page needs a bunch more clarity before titles are handed out
13:27:03 <fifieldt_> I'm all for the idea, just don't want to see it fall down due to a lack of planning/definition
13:27:11 <koolhead17> +1
13:27:21 <annegentle> fifieldt_: yeah I'm with you. the projects are quite disparate so I want some sort of matrix for more analysis
13:27:43 <fifieldt_> matrix still sounds like the line of thinking is more about people than what they do :)
13:28:03 <koolhead17> haha
13:28:10 <fifieldt_> hi AJaeger :)
13:28:21 <annegentle> mostly I've told Sean that I'd rather we have overarching book owners
13:28:28 <sgordon> +1
13:28:31 <fifieldt_> sure
13:28:31 <annegentle> that's the direction we're taking the openstack-manuals repo too
13:28:32 <AJaeger> Hi everyone, sorry for beeing late. Only just say the note on -doc.
13:28:36 <annegentle> AJaeger: welcome
13:28:40 <fifieldt_> but what does that 'mean' :)
13:29:02 <fifieldt_> don't feel the need to answer in this meeting (time is short)
13:29:06 <fifieldt_> but that's just where I'm thinking
13:29:07 <annegentle> so, you can see why I haven't finished this action item
13:29:08 <annegentle> right
13:29:11 <fifieldt_> indeed
13:29:19 <annegentle> last action: fifieldt to see design resources for the docs.openstack.org landing page for 1. translation 2. releases
13:29:35 <annegentle> fifieldt_: I talked to Todd Morey last week, he doesn't have a redesign though for us
13:29:38 <fifieldt_> I believe you made more progress with this than I did annegentle
13:29:41 <annegentle> fifieldt_: he has one for www though
13:29:49 <fifieldt_> yeah, I grabbed him on skype too ... same result
13:30:03 <fifieldt_> it's unlikely to happen within the "soon" timeframe :)
13:30:03 <annegentle> so I'll call this in progress, and necessary before Oct 17, but ongoing
13:30:16 <annegentle> #topic Docs Boot Camp - https://wiki.openstack.org/wiki/Docs_Bootcamp_2013
13:30:25 <annegentle> welcome boris-42
13:30:40 <boris-42> annegetnle HI
13:30:42 <annegentle> Boot camp is shaping up, thanks fifieldt_ roadnick and shaunm for the help
13:30:45 <annegentle> :)
13:30:52 <roadnick> Hello, boris-42
13:31:00 <annegentle> any questions about boot camp? roadnick needs to sign up :)
13:31:08 <koolhead17> annegentle, i will be there too.
13:31:13 <roadnick> Ha!  Yes, I will. :)
13:31:20 <roadnick> I also need to book travel, I realized yesterday
13:31:25 <annegentle> koolhead17: yeah I saw you signed up, woo
13:31:26 <roadnick> Me and Nermina
13:31:28 <boris-42> Could somebody say about what we are speaking now?)
13:31:29 <boris-42> sorry=)
13:31:32 <sgordon> i added some info to the wiki about obtaining/installing Publican
13:31:35 <annegentle> #topic Boot Camp
13:31:41 <annegentle> boris-42: sure, sorry forgot to change the topic
13:31:49 <koolhead17> annegentle, thanks to my employer for this :)
13:31:55 <sgordon> im planning a pretty basic overview/tutorial though as it's not really an openstack-manuals tool
13:32:02 <annegentle> we're talking about boot camp, going through https://wiki.openstack.org/wiki/Meetings/DocTeamMeeting#Agenda_for_next_meeting
13:32:07 <sgordon> more of a "this is some other docbook stuff that is out there" exercise
13:32:17 <annegentle> sgordon: I think that's helpful
13:32:34 <annegentle> the idea is to share as much info to spread the knowledge
13:33:11 <roadnick> I also need to know if I'm speaking and on what; do you want me to do up a version of the "how to contribute" doc I'm finishing as a presentation?
13:33:11 <annegentle> and get to know each other
13:33:20 <boris-42> annegentle Ah nice
13:33:48 <annegentle> We've got 18 signed up so far with four more expected (like roadnick and Nermina who haven't signed up yet) :)
13:33:56 * slong is envious
13:34:04 <annegentle> we'll record sessions (with speaker's permissions)
13:34:12 <boris-42> annegentle so and todays goal is?)
13:34:15 <annegentle> slong: if your employer would give you the time, we can ask the Foundation for funding for you
13:34:25 <annegentle> boris-42: this is our usual monthly doc team meeting
13:34:29 <annegentle> boris-42: we go through the agenda
13:34:30 <slong> seriously?
13:34:35 <annegentle> slong: yes
13:34:40 <koolhead17> slong, :)
13:34:45 <slong> I wil ask!
13:34:49 <fifieldt_> :)
13:35:03 <annegentle> fifieldt_: you want to help slong with that?
13:35:05 <slong> You do realise I'm in Australia??
13:35:09 <annegentle> slong: yeah
13:35:09 <annegentle> :)
13:35:14 <slong> :)
13:35:25 <annegentle> for Monday's nights outing, what are people interested in?
13:35:29 <fifieldt_> annegentle, let's smash some email back and forth
13:35:34 <annegentle> fifieldt_: sounds good, thanks
13:35:34 <boris-42> annegentle And as I know I wasn't member of this team, so I am glad to help, but at this moment it is not so clear for me how can I help?) could you explain?)
13:36:11 <annegentle> boris-42: ah you can just listen in then, sorry I thought you were another boris I guess
13:36:46 <annegentle> ideas for Monday: computer museum is close by, go to the Village, go to the Academy of Science, or Exploratorium
13:36:47 <boris-42> annegentle I am Boris Pavlovic from Mirantis
13:36:59 <koolhead17> annegentle, me2 :D
13:37:25 <roadnick> Hi, Boris, this is Nick. :)
13:37:30 <koolhead17> boris-42, i thought the other Boris from mirantis :) you are close
13:37:35 <annegentle> boris-42: ok, I thought you were from Mirantis. If you work in the Mountain View office you might have ideas for us for an outing
13:38:02 <annegentle> I also like this old book store in old Mountain View.
13:38:15 <roadnick> let me see if I can get some quick ideas from David, he's online
13:38:19 <annegentle> so, book stores? museums? video games?
13:38:25 <annegentle> roadnick: I've been emailing him and Anne Friend
13:38:31 <annegentle> roadnick: with the ideas I'm listing
13:38:33 <roadnick> ah, ok
13:38:45 <annegentle> want to get input
13:38:57 <annegentle> the computer museum is about 2 miles from where we'll be
13:39:02 <shaunm> annegentle: how many are we expecting?
13:39:05 <annegentle> the book store is less than 5 miles
13:39:09 <roadnick> Unfortunately I'm on the other end of the country, so I have no idea.
13:39:10 <annegentle> shaunm: 20+
13:39:13 <sgordon> i would be +1 on the computer museum but i have never been to san fran
13:39:18 <sgordon> so anywhere is new
13:39:29 <annegentle> sgordon: yeah I've never been to that computer museum but I hear its cool
13:39:40 <shaunm> computer museum sounds fun
13:39:54 <annegentle> ok I'll work on transportation and dinner plans
13:39:57 <roadnick> it does sound fun, but will it be open in the evening?
13:39:57 <shaunm> it's hard to keep a group of more than about a dozen together
13:40:28 <shaunm> but it's probably no big deal if people split into some smaller groups
13:40:55 <annegentle> shaunm: ok that makes sense
13:41:06 <koolhead17> annegentle, pleia2 will be our local guide. I remember she did that for us last time in UDS :)
13:41:06 <annegentle> ok any more questions on boot camp?
13:41:14 <roadnick> the museum is closed monday and tuesday
13:41:15 <roadnick> :(
13:41:22 <annegentle> roadnick: NOooo...
13:41:24 <annegentle> bummer
13:41:29 <annegentle> well that's good to find out now :)
13:41:34 <annegentle> koolhead17: I'll reach out to pleia2
13:41:34 <roadnick> yep, bummer
13:41:44 <koolhead17> annegentle, i have not received any ack for my participation
13:41:45 <roadnick> we should set up a separate meeting to plan the presos
13:41:51 <annegentle> koolhead17: you're signed up.
13:41:54 <annegentle> koolhead17: there you go :)
13:42:00 <koolhead17> cool. thanks :D
13:42:11 <annegentle> roadnick: yeah good idea
13:42:22 <annegentle> roadnick: you want to do that? You have emails for all the speakers right
13:42:37 <koolhead17> annegentle, speakers? o.0
13:42:47 <annegentle> ok we already talked about the v3 Compute API doc plan so let's go on to
13:42:53 <annegentle> #topic Bug report, DocImpact state
13:43:12 <annegentle> fifieldt_: you have any comments?
13:43:26 <fifieldt_> just the stuff from the recent email
13:43:36 <fifieldt_> progress is being made
13:43:38 <annegentle> Okay. Automation is working great for DocImpact, I have to say!
13:43:43 <fifieldt_> indeed
13:43:59 <fifieldt_> noticable in: http://webnumbr.com/untouched-bugs-in-openstack-manuals-
13:44:03 <koolhead17> shaunm, how are we doing with the deployment guide
13:44:10 <annegentle> #link https://launchpad.net/openstack-manuals/+milestone/havana
13:44:18 <fifieldt_> api is basically waiting for the nova v3 things for a lot of the bugs
13:44:39 <fifieldt_> manuals - managed to tick off a lot of them thanks to openstack-config ref :)
13:44:50 <annegentle> fifieldt_: did the Xen doc bugs get targeted or collected? That would help the numbers
13:44:55 <shaunm> koolhead17: progress is slow at the moment, unfortunately
13:45:02 <fifieldt_> the blueprint links all the bugs
13:45:14 <koolhead17> shaunm, we are meeting next month right?
13:45:15 <fifieldt_> xen blueprint that is
13:45:16 <fifieldt_> moment
13:45:28 <fifieldt_> #link https://blueprints.launchpad.net/openstack-manuals/+spec/redocument-xen
13:45:30 <annegentle> fifieldt_: okay so it gathers them, that's good.
13:46:00 <fifieldt_> also went through a bunch of blueprints that had been sitting there
13:46:02 <fifieldt_> and triaged them
13:46:08 <fifieldt_> so check that out if you get a moment
13:46:28 <roadnick> I did notice that you changed the Admin Manual Modularization from "new" to "discuss"
13:46:49 <fifieldt_> indeed
13:46:59 <fifieldt_> well I just tried to make the virtual world reflect reality
13:47:04 <roadnick> We had kind of stalled on that dicussion trying to decide whether to move foreward
13:47:09 <roadnick> forward*
13:47:10 <shaunm> koolhead17: at the boot camp you mean?
13:47:24 <annegentle> Diane knocked out 20 bugs in a few weeks, at least 24 went in with the autodoc patch, are we just not keeping up with coders?
13:47:28 <annegentle> what's your sense of it?
13:47:38 <koolhead17> shaunm, ya
13:47:48 <shaunm> yup
13:47:53 <koolhead17> cool.
13:47:53 <annegentle> roadnick: yeah I think we are still discussing admin manuals
13:47:59 <fifieldt_> annegentle, we're doing better than we ever have :)
13:48:07 <annegentle> fifieldt_: for SURE!
13:48:12 <slong> fifieldt, did you do work on the config ref blueprint?
13:48:29 <fifieldt_> slong, I put in a patch for the neutrons
13:48:37 <fifieldt_> to show the kind of breakdown we were talking about
13:48:42 <sgordon> oh got there are multiple neutrons?
13:48:43 <sgordon> ;p
13:48:45 <fifieldt_> and tried to look at the filenames
13:48:47 <koolhead17> annegentle, do you want me to shoot a mail to the dev list regarding this https://wiki.openstack.org/wiki/Documentation/ProjectDocLeads
13:48:51 <annegentle> roadnick: did you follow the -dev list post for the havana doc plan?
13:48:58 <koolhead17> ask the PTL to get us some one from there team
13:49:07 <slong> nice, fifieldt
13:49:24 <fifieldt_> take a look at http://docs.openstack.org/trunk/openstack-config/content/networking-options-reference.html
13:49:32 <annegentle> koolhead17: it probably has to come from me? What do others think? I'm not a huge fan of the idea in the current form, instead I want book owners. But I would like liaisons and some PTLs have identified those.
13:49:34 <roadnick> annegentle: peripherally; I need to go back and review now that I'm more conscious :)
13:49:35 <fifieldt_> just stub sections
13:49:42 <fifieldt_> but with a paragraph in there for each block
13:49:44 <annegentle> roadnick: conciousness is good :)
13:49:44 <fifieldt_> could become something good
13:49:51 <fifieldt_> but yeah, still got the filename problem
13:50:12 <koolhead17> annegentle, sounds good. lets modify it & then reach out to the PTL
13:50:16 <annegentle> koolhead17: add candidate people to the wiki page but I will communicate
13:50:28 <sgordon> annegentle, my concern is it probably needs to be driven via the TC
13:50:41 <fifieldt_> by the way - we have an icehouse series and milestone
13:50:46 <annegentle> sgordon: I'm on the TC so that's why I should communicate the idea.
13:50:48 <sgordon> (and/or the PTLs obviously)
13:50:51 <fifieldt_> so feel free to target blueprints into the future :)
13:50:51 <sgordon> right
13:50:53 <annegentle> sgordon: exactly
13:50:55 <koolhead17> :)
13:51:09 <annegentle> ok, let's move to open discussion
13:51:16 <annegentle> #topic Open Discussion
13:51:27 <EmilienM> annegentle: hey
13:51:29 <annegentle> I think I should have had fifieldt_ do the topic changes
13:51:32 <annegentle> oh well
13:51:35 <EmilienM> https://blueprints.launchpad.net/openstack-manuals/+spec/improve-high-availability-support
13:51:36 <annegentle> EmilienM: hey
13:51:36 <fifieldt_> sorry annegentle
13:51:40 <fifieldt_> #topic open discussion
13:51:42 <annegentle> I want to know who's going to HK?
13:51:48 <EmilienM> o/
13:51:49 * fifieldt_ is :D
13:52:07 <fifieldt_> I'd like to call attention to this review, for slong and sgordon: https://review.openstack.org/#/c/41623/ :)
13:52:12 <koolhead17> fifieldt_, :P
13:52:15 <EmilienM> roadnick and I still work on https://blueprints.launchpad.net/openstack-manuals/+spec/improve-high-availability-support
13:52:16 <roadnick> NOT me
13:52:25 <roadnick> (for HK, that is)
13:52:30 <sgordon> annegentle, i am actually just reworking our travel request
13:52:31 <fifieldt_> awww man
13:52:50 <sgordon> so at the moment cant really confirm
13:53:10 <slong> right on, fifieldt!
13:53:38 <annegentle> sgordon: cool
13:53:58 <annegentle> if it helps with travel plans, it looks like docs will be afternoon Tues.
13:54:06 <annegentle> four slots, same as Portland
13:54:07 <EmilienM> roadnick: do you want to talk about https://blueprints.launchpad.net/openstack-manuals/+spec/improve-high-availability-support ?
13:54:15 <AJaeger> fifieldt, I have no problems with the current state. What caused me mild frustration was the patch going in since it touched so many files.
13:54:25 <annegentle> I am still noodling on whether to get rid of Admin Guides
13:54:31 <annegentle> I've been doing some Google Analytics work.
13:54:45 <fifieldt_> ooh :D
13:54:45 <koolhead17> annegentle, i think admin guide is needed :)
13:54:49 <annegentle> For sure the analytics back up the idea that we CAN go to continuous publishing for many many guides.
13:55:00 <annegentle> koolhead17: there will be a new Admin User Guide.
13:55:11 <annegentle> koolhead17: so it's possible to get rid of the Compute Admin Manual for example.
13:55:18 <koolhead17> annegentle, ooh okey
13:55:28 <annegentle> koolhead17: and possibly the Object Storage Admin guide, by moving the config info out, such as S3
13:55:35 <annegentle> I think we could do a lot of purging safely
13:55:42 <annegentle> so I wanted to give a heads up that's a possiblity
13:56:03 <koolhead17> annegentle, will talk in few weeks on the same.
13:56:06 <annegentle> I still don't know where to put Block Storage other than in the Config Guide (since it's mostly about configuring different storage backends)
13:56:16 <annegentle> and the Networking Admin Guide, just makes me worry.
13:56:28 <sgordon> annegentle, i have verbal approval for at least one of us im just updating the costs
13:56:30 <annegentle> shaunm: I also worry a lot about the install guide
13:56:34 <sgordon> plan is for attendance at all 4 days
13:56:37 <fifieldt_> a worried annegentle is not a good thing :(
13:56:38 <koolhead17> sgordon, coool
13:56:42 <annegentle> sgordon: yeah if you can get there go all the time! :)
13:56:48 <annegentle> fifieldt_: oh it's all the time :)
13:56:53 <koolhead17> fifieldt_, :)
13:56:55 <roadnick> emilienm: since I've been out, why don't you take that for today; you have a better handle right now.
13:57:10 <EmilienM> ok
13:57:20 <EmilienM> we still have some work to do.
13:57:28 <shaunm> annegentle: well, I do too
13:57:28 <EmilienM> what I would like first, is to finish main sections
13:57:44 <annegentle> shaunm: oh yes not saying otherwise :) Just sharing concerns
13:57:44 <EmilienM> and then fix subsections with more precisions
13:58:03 <annegentle> I also wanted to say something about review policies --
13:58:05 <EmilienM> #link http://docs.openstack.org/trunk/openstack-ha/content/ha-using-active-active.html
13:58:16 <annegentle> I know it has been hard to get stuff merged lately with all the markup changes, sorry about that.
13:58:20 <annegentle> but we're getting into a good state
13:58:22 <shaunm> annegentle: next release is in october?
13:58:27 <annegentle> for welcoming all the contributors :)
13:58:34 <annegentle> shaunm: Oct 17 is go live
13:58:43 <shaunm> that's feeling less and less like plenty of time
13:58:45 <annegentle> shaunm: feature freeze is coming up a month sooner
13:58:48 <annegentle> shaunm: yes
13:59:06 <annegentle> #link https://wiki.openstack.org/wiki/Havana_Release_Schedule
13:59:19 <AJaeger> annashen, regarding markup changes: Let's keep in mind to record our policies on the conventions page.
13:59:21 <annegentle> I expect we'll see lots of doc interest come Setp. 5th
13:59:30 <annegentle> AJaeger: yes, good idea.
14:00:00 * AJaeger was surprised what he learned from (great!) reviews that wasn't really codified and where I had to guess what it means...
14:00:01 <annegentle> So here's a draft policy - get at least one +2 before merging when 2 or more files are changed, but if it's small changes, a core can just push it through.
14:00:25 <annegentle> AJaeger: yeah I was thinking the same thing about new people wondering "well what do I have to do to get this merged?" :)
14:00:38 <annegentle> fifieldt_: can you record an action for me to codify our reviewing policies
14:00:49 <annegentle> and we're on the hour, again I apologize for being late
14:00:51 <fifieldt_> #action annegentle  codify our reviewing policies
14:01:01 <AJaeger> annegentle, or: If it touches more than one book?
14:01:05 <annegentle> fifieldt_: oh anyone can do actions :) sorry
14:01:15 <fifieldt_> no worries :)
14:01:16 <annegentle> AJaeger: yeah if it touches more than one book definitely want 2 cores to look
14:01:41 <annegentle> AJaeger: but if I want to get patches moving I'll +2 on my own if I'm confident
14:01:49 <annegentle> AJaeger: so that's sort of out of policy I suppose :)
14:02:11 <annegentle> AJaeger: though I do want other cores to have that same confidence and push
14:02:33 <annegentle> AJaeger: we're a small enough team that we can move things through as needed without waiting for others
14:02:34 <fifieldt_> I take it everyone has also seen
14:02:35 <fifieldt_> #link http://russellbryant.net/openstack-stats/docs-openreviews.html
14:02:40 <AJaeger> annegentle, let's not be too strict...
14:02:43 <annegentle> sgordon: fifieldt_: does that sound about right?
14:02:54 <fifieldt_> aye, annegentle
14:02:57 <annegentle> fifieldt_: ohhh that's handy
14:03:04 <fifieldt_> Longest waiting reviews (based on latest revision):
14:03:05 <fifieldt_> 74 days, 17 hours, 33 minutes https://review.openstack.org/31119 (Add os-instance_usage_log_audit extension)
14:03:06 <fifieldt_> :D
14:03:20 <annegentle> fifieldt_: LOL wow
14:03:34 <fifieldt_> the page helps me remember to check not just openstack-manuals
14:03:35 <annegentle> Ok, let's end it and always feel free to talk on openstack-doc all!
14:03:38 <fifieldt_> but also places like operations-guide
14:03:38 <annegentle> Gotta get a kiddo to the docs
14:03:41 <sgordon> annegentle, i am a little hesitant at the moment but yes with time
14:03:41 <fifieldt_> cool
14:03:44 <fifieldt_> I might sleep instead
14:03:48 <annegentle> sgordon: sure
14:03:56 <sgordon> i had one more thing actually
14:04:00 <annegentle> sgordon: sure
14:04:00 <fifieldt_> ya?
14:04:08 <AJaeger> Anybody wants to ask Diane what to do with 31119?
14:04:11 <sgordon> i was wondering if people think meeting monthly is enough, or perhaps we could move to fortnightly
14:04:13 <sgordon> just a though
14:04:24 <fifieldt_> AJaeger, it needs samples
14:04:28 <fifieldt_> which may not be in the code
14:04:30 <sgordon> my feeling is that touching base like this 6 times a release may be underdoing it
14:04:34 <sgordon> just my 2c though
14:04:35 <annegentle> sgordon: hehe I had to look up forthnightly
14:04:38 <sgordon> wondering what others think
14:04:44 <annegentle> sgordon: yeah I'm with you
14:04:50 <roadnick> +1
14:04:54 <sgordon> sorry, despite my geographic disposition i still speak 'strayan
14:04:55 <fifieldt_> +1
14:04:57 <annegentle> We can go to weekly even
14:05:10 <koolhead17> hehe
14:05:12 <annegentle> weekly? Every other? twice a month?
14:05:15 <EmilienM> =1
14:05:20 <slong> +1 for fortnightly
14:05:21 <sgordon> i would move to every other to start with imo
14:05:27 <annegentle> sgordon: wanna propose it to the mailing list?
14:05:30 <sgordon> sure
14:05:42 <annegentle> #action sgordon propose more often meetings on -docs Mailing List
14:05:50 <EmilienM> I agree
14:05:59 <annegentle> sgordon: yeah every other for starters sounds good
14:06:05 <sgordon> i think the fact the last couple we have run the full hour and then some
14:06:12 <sgordon> is an indication we could meet more often :)
14:06:17 <annegentle> heh yeah
14:06:19 <koolhead17> sgordon, thanks for reminding us about meetup today :)
14:06:22 <annegentle> ok let's end it
14:06:25 <sgordon> yup
14:06:28 <fifieldt_> yay
14:06:29 <annegentle> thanks all!
14:06:39 <fifieldt_> #endmeeting Doc Team Meeting