03:00:45 #startmeeting docteam 03:00:46 Meeting started Wed Sep 3 03:00:45 2014 UTC and is due to finish in 60 minutes. The chair is loquacities. Information about MeetBot at http://wiki.debian.org/MeetBot. 03:00:47 Useful Commands: #action #agreed #help #info #idea #link #topic #startvote. 03:00:50 The meeting name has been set to 'docteam' 03:01:01 #topic Action items from the last meeting 03:01:12 annegentle to write spec for docs site redesign/experience design 03:01:33 hello 03:01:37 hello! 03:01:41 annegentle: you there? 03:01:41 hi everyone 03:01:44 I'd love to see this... annegentle - can I see progress on this? 03:01:45 * annegentle waves 03:01:46 hi dnavale 03:01:50 hi 03:02:03 I have a draft, fifieldt and I need to meet to move forward on it 03:02:09 ah 03:02:26 ok, the other one was Anne to ask Sam Harwell to add docs-core to the clouddocs-maven-plugin review team 03:02:27 sld: what's your interest area? 03:02:34 that's done 03:02:41 thought so 03:02:48 whew! 03:02:59 #topic Blueprint reviews 03:03:00 annegentle: the proposed solutions, timeframe, etc... all of it. :) 03:03:36 so i assume that means we need to do some? 03:03:48 BP reviews? 03:03:59 yeah 03:04:04 that's what I am thinking, based on that... 03:04:09 annegentle: ? 03:04:11 (i read that as 'blood pressure reviews') 03:04:15 lol 03:04:25 ha ha 03:05:32 ok, moving on 03:05:42 #topic Networking Guide status 03:06:02 so i think that's still firmly in progress 03:06:17 yeah....needs a lot of work, but is in progress 03:06:18 #link https://wiki.openstack.org/wiki/NetworkingGuide/TOC 03:06:21 absosmurfly 03:06:28 we need to all agree to the spec 03:07:23 #topic Website design and contributor experience status 03:07:39 do you have an update on that annegentle? 03:07:53 I talked to Tom at the Ops Meetup last week and he wants a longer conversation, so need to sync with him. 03:08:05 ok, cool 03:08:15 #topic HOT Template Guide status 03:08:22 the basic idea is to hire a contract designer to give us a page design (which would co-exist with book designs/experiences as well) 03:08:37 yep, i think that was the status last i heard 03:08:45 ..and then we just split it into includes, and customize it accordingly? 03:08:48 sounds like the HOT guide is still ongoing? 03:09:38 its hot 03:09:41 heh 03:09:43 toasty 03:10:13 #topic API docs status 03:10:58 i have no insight into this one 03:11:21 re: hot guide, was just looking into reviews, but don't see any 03:11:44 re: API docs, just wanted to say I emailed all 21 PTLs with the plan to remove WADL references from the long-form documents and have no input 03:11:52 heh 03:12:14 the networking API guide is particularly troublesome since it doesn't have complete WADL coverage and they have two LBaaS APIs 03:12:24 21? woah...didn't know there were that many. 03:12:26 so the status is "slow" 03:12:49 sld: yeah but not that many APIs 03:12:50 sounds about right 03:12:55 #topic Doc tools status 03:13:02 maven plugin update? 03:13:58 Oh I was going to mention doc8 03:14:05 oh, right 03:14:06 it's a new separately installed tool 03:14:07 go ahead :) 03:14:40 what does it do? 03:14:45 if you have current openstack-doc-tools installed you need to pip install pep8, if you're working on a fresh system, you'll get it through requirements (right Sam-I-Am?) 03:14:50 throw a lot of errors :) 03:15:06 ouch >< 03:15:11 it'll build whenever you build tox stuff 03:15:17 it helps with niceness (whitespace) and line length and matching python pep8 standards 03:15:23 right 03:15:27 which is awesome. 03:15:29 if you build it a while ago, rebuild 03:15:32 built 03:15:38 right 03:15:42 otherwise it goes bork 03:15:55 rebuild which? 03:15:58 heh 03:16:24 as for the maven plugin, I want a new release with those items I mentioned in the ML post, but don't have a delivery date from the team who can release it 03:17:00 that's all I can think of for tools 03:17:10 annegentle: rebuild your tox... scripts? 03:17:39 thanks :) 03:17:43 #topic Doc bug day - 9 September 03:17:50 don't forget! 03:18:00 #link https://wiki.openstack.org/wiki/Documentation/BugDay 03:18:04 will be there.. 03:18:10 ah, thanks JRobinson__ 03:18:13 np 03:18:15 i just went to go looking for it ;) 03:18:27 a week from today. 03:18:33 looks like we need more 'mentors' in that table, too 03:18:39 yes thank you for reminding! 03:19:16 * Sam-I-Am signs up for all 24 hours 03:19:20 at this rate... 03:19:27 lol 03:19:38 that's dedication, right there ... 03:19:41 I can do some night hours, but not sure what to think of the table, since the time zone is all over the place there. 03:19:54 its utc time 03:19:55 it's in UTC 03:19:59 we're -5 03:20:12 whats with the eastern / central / etc... on there for then? 03:20:19 confusing. 03:20:21 sld: http://www.timeanddate.com/worldclock/converter.html is your friend 03:20:30 that's the working hours in that tz 03:20:35 not sure what that is for... maybe region coverage? 03:20:51 which is why you see my name in the 'australia' bits 03:20:56 ah 03:20:59 Sam-I-Am: who to ask for help during those times 03:21:30 so right now it is 3am utc? 03:21:45 yep, 3:20 03:22:12 ok, that's all i have on the agenda 03:22:15 #topic Open discussion 03:22:17 n/m... i see you (loquacities) on a bunch of the hours i could help with... so no need to add me i guess, but i can help *additionally* for a lot of the same hours, if needed. 03:22:34 i don't think there's a limit of one person/hr 03:22:38 hehe :) 03:22:39 sld: yeah feel free to double up for sure 03:22:40 so just add your name next to mine 03:22:43 k. 03:22:50 that way we can cover for each other 03:22:54 annegentle: i was just wondering about the third column. now i know :) 03:23:06 and somehow i read it as 'timezone hangover' 03:23:10 lol 03:23:17 you need more sleep, Sam-I-Am :P 03:23:18 WRT Guides - I was talking to a trainer (here at RS) who is interested in putting a lot of work into these - http://docs.openstack.org/training-guides/content/ 03:23:18 heh 03:23:30 sld: cool 03:23:31 oh, cool! 03:23:50 RE: Opendiscussion - not sure if this was covered earlier in the API discussion, but does the Lbaas still need v1 and v2 wadls in the repo? 03:23:51 sld: the training team is a separate team, somewhat "incubating" in the docs program 03:23:56 he is out this week, but i'll email him next week to see how soon we can set him up as a contributor :) 03:24:01 heh 03:24:08 JRobinson__: yep... the v2 LBaaS needs to be marked "experimental" as of last week 03:24:21 sld: cool. they have a training team meeting on Mondays at noon Central 03:24:28 oh, we should probably mention summit too 03:24:29 k. i'll let him know. 03:24:32 who's going? 03:24:32 annegentle, ok 03:24:35 not me! 03:24:36 yeah summit! me. 03:24:38 i wish i could! 03:24:41 me! 03:24:43 :D 03:24:43 i want to so bad :( 03:24:54 sld, i'll pack you in my suitcase? 03:24:55 i'll be there 03:25:00 i wish 03:25:05 sld: we can party it up in SA 03:25:06 moi 03:25:11 annegentle and i are giving a talk 03:25:16 ah 03:25:21 I'll be there 03:25:22 let me help, so i can go too. hehe 03:25:28 and so is asettle 03:25:43 JRobinson__, you're coming to summit?! 03:25:49 actually, asettle has two talks 03:26:00 Yeah, the talk lord all of a sudden. Ha. 03:26:00 JRobinson__: openstack summit 03:26:00 i'm waiting for the stateside one 03:26:09 wow.. way to go asettle :) 03:26:14 sorry, was confused - will be in us in two weeks not OS summit 03:26:15 dnavale, you say that now. 03:26:20 :p 03:26:23 heh 03:26:45 all the meetings begin with "s" - summit, swarm, sprint 03:26:59 We like to S it up 03:26:59 lol 03:27:13 That could be taken as 'we like to sit up' *chuckles to self* 03:27:17 heh, ok, on that note, let's SUM it up 03:27:24 (haha, i crack me up) 03:27:30 Between the two of us dude :p 03:27:38 \o/ 03:27:39 lol 03:27:41 #endmeeting