14:01:20 #startmeeting DocTeam 14:01:21 Meeting started Wed Feb 12 14:01:20 2014 UTC and is due to finish in 60 minutes. The chair is annegentle. Information about MeetBot at http://wiki.debian.org/MeetBot. 14:01:22 Useful Commands: #action #agreed #help #info #idea #link #topic #startvote. 14:01:24 The meeting name has been set to 'docteam' 14:01:32 o/ 14:01:39 I think I use a different meeting name and that's bad because then eavesdrop has different folder names. Ah well. 14:01:53 I'm here. :) 14:01:57 good morning, all. 14:02:15 Agenda is here: 14:02:17 #link https://wiki.openstack.org/wiki/Meetings/DocTeamMeeting#Agenda_for_next_meeting 14:02:18 i'm here too, visiting from the future 14:02:22 hey nickchase 14:02:26 loquacities: how's tomorrow? 14:02:35 #topic Action items from the last meeting 14:02:36 only started a minute and a half ago 14:02:39 so it's a bit early to tell 14:03:12 All we had was slong to update the howto with the new tools update 14:03:17 I think that was about test.py changing 14:03:27 that's correct 14:03:36 i'm not sure if that's done or not, though, i haven't gone looking 14:03:43 the one before that was annegentle to email Sam-I-Am for networking details on a slide for webinar 14:03:55 Uh, I don't think I did that, but I don't think the webinar is going to happen, so that's just fine 14:04:02 AJaeger to create a separate CLI Reference to get input from reviewers 14:04:08 That's done, woo! 14:04:19 lastly, annegentle to find out if Oxygen XML is interested in continuing to support OpenStack with donated licenses 14:04:19 booo 14:04:22 that's done as well 14:04:33 aww, no webinar :( 14:04:33 are they? 14:04:35 Sam-I-Am: oh believe me I'm fine with no webinar there's enough going on :) 14:04:51 nickchase: yeah I sent an email to the ML - we got 10 more, one I've given away. 14:04:57 Probably I'll save another for slong 14:05:07 but other wise they're up for grabs 14:05:15 annegentle: true 14:05:35 i'll mention that next week for apac 14:05:46 loquacities: yes please do 14:05:58 Ok next topic if that's all the action items to follow up on 14:06:02 #topic Doc tools update - 0.6 release of openstack-doc-tools 14:06:29 heh Looks like I'm behind already 14:06:42 0.6 release fixed the python packaging 14:06:51 and there's an upcoming 0.7 it looks like 14:06:53 #link https://github.com/openstack/openstack-doc-tools 14:07:30 Lots of great progress on translated documents. Much appreciation. 14:07:38 I'll check with Andreas on 0.7 14:07:57 hello 14:07:58 Any doc tools questions? 14:08:02 hey chandan_kumar! 14:08:07 HI 14:08:21 hello 14:08:57 Hi AJaeger :) 14:09:09 Do you need a 0.7 AJaeger? I see it on the release notes section 14:09:24 annegentle, not yet - first need to merge all the changes in. 14:09:42 And I would prefer if people that request features, also review them at least a bit... 14:09:53 AJaeger: yes good thinking 14:10:09 * AJaeger doesn't want to self-approve without any +1s at all. 14:10:20 AJaeger: agreed 14:10:33 Still, doing it far too often for minor things - if somebody likes to review, I happily wait for you! 14:10:42 AJaeger: I'll look today, I was definitely offline a lot yesterday 14:11:09 I don't think David Cramer's here to ask him anything. 14:11:18 dianefleming: can you think of any report for the maven plugin? 14:11:19 Thanks, annegentle. Shall I add you to features for review? 14:11:39 AJaeger: I think I'm subscribed to changes on the repo 14:11:50 annegentle, great! 14:12:04 dianefleming has been working on automating the table of contents / sidebar nav for the API reference page 14:12:16 that's the only feature that's new for us for clouddocs-maven-plugin 14:12:29 yes! 14:12:29 There're two more that interest me: 14:12:37 Linking to ask.openstack.org 14:12:39 i will be reviewing all the doc-tool reviews 14:12:44 AJaeger: oh yes! Thank you. 14:12:46 sorry, stepped away to get coffee 14:12:54 dianefleming: man I need to get coffee :) 14:13:03 annegentle: it helps 14:13:08 slurrrrp 14:13:09 AJaeger: is there a review in place for the link to ask? 14:13:14 i have another one coming to clouddocs-maven-plugin - adding PDF links to the API ref pages 14:13:21 Better way of handling targetdir, this will allow to copy only needed files to the server and remove the delete jobs we have in a few cases 14:13:26 AJaeger: and how do we time that to prevent it changing stable/havana output? 14:13:31 It's merged already 14:13:35 AJaeger: ok cool 14:14:04 for ask.o.o: Will only change havana if we update the pom 14:14:05 AJaeger: oh nevermind my question about preventing changes, it's a version in the pom.xml. Forgive my brain pause. 14:14:09 AJaeger: :) 14:14:17 The deltion: Only when we switch to new plugin for havana 14:14:23 annegentle, exactly ;) 14:14:38 AJaeger: shall I ask David for a release this week or next? 14:15:18 if dianefleming's change for the API site is in: Yeah, ready to release anytime IMHO. 14:15:41 AJaeger: ok sounds good 14:15:50 Ok anything else on tools? 14:15:55 david cramer needs to approve my change on api-site 14:16:00 i'll ping him 14:16:07 dianefleming: ok good 14:16:10 #topic Style Guide for config strings 14:16:33 dianefleming put together a style guide similiar to the config strings one 14:16:35 #link https://review.openstack.org/#/c/70778/5 14:16:42 We can keep reviewing -- just wanted to mention it. 14:16:48 dianefleming: are you also adding to HACKING.rst? 14:16:57 dianefleming: I'll clarify the "admin only" comment 14:17:04 yes, and someone asked that I move it to HACKING.rst in python-novaclient 14:17:13 I'm still struggling where this belongs - whether it can be an enhancement to oslo.config or should go to the hacking repository 14:17:31 dianefleming, don't move it to HACKING.rst in novaclient. It should apply everywhere! 14:17:38 well, who is the audience? and where would they be most likely to look for this information? 14:17:47 My suggestion would be hacking repository 14:17:56 ok - wasn't aware of hacking repo - 14:17:58 will put it there 14:17:59 That contains our coding guidelines 14:18:03 ok 14:18:17 dianefleming: yeah I wasn't sure either, so good to ask 14:18:17 and if nobody likes it, we'll take it in openstack-doc-tools ;) 14:18:23 AJaeger: good! 14:18:27 okay - sounds like a plan 14:18:31 Okie 14:18:32 i'll take care of that this morning 14:18:36 dianefleming: sounds good 14:18:39 Ok moving along 14:18:48 #topic Next APAC docs meeting f2f in Brisbane 14:18:54 loquacities: that's cool! 14:19:20 haha 14:19:34 yep, so there's a fairly large concentration of openstack writers in brisbane 14:19:43 and we've been talking about having a get together for a little while 14:19:52 so it made some sense to tie it into the apac meeting 14:19:52 * Sam-I-Am moves to brisbane 14:19:55 loquacities, make a group photo to share! 14:20:06 red hat have kindly offered to host it in their new meeting space 14:20:07 loquacities: that is super cool 14:20:09 for sure! 14:20:40 Okay go to loquacities for any more details :) 14:20:41 so we'll still be on irc for anyone who wants to join in 14:20:49 ah, cool. i was just going to ask that. 14:21:02 loquacities: ok I'll try to hang out on IRC then too 14:21:09 but all the brisbanites will be in a room together :) 14:21:12 that'd be awesome 14:21:16 thanks for the support 14:21:26 #topic Operations Guide edits from O'Reilly, master and feature/edits branches 14:21:27 might be at some "crazy" hour ;) 14:21:39 So we have a new branch of the openstack/operations-guide repo 14:21:44 it's called feature/edits 14:21:49 is it pushed to github? 14:21:54 We can move anything from master to feature/edits and vice versa 14:21:56 AJaeger: yep 14:22:33 O'Reilly sent an annotated PDF of edits for ch 1-7 last night, so we'll be updating master with those, and then I'll port to feature/edits 14:22:48 Ah, found it! 14:22:51 Mostly it's for consistency - like getting the two architectures more parallel, tables, etc 14:23:05 AJaeger: yeah I need to find the instructions for porting back and forth so I'm ready to try some! 14:23:10 annegentle: that was quick 14:23:21 annegentle: i could use some instructions too 14:23:23 Sam-I-Am: yeah they're minor really, it's not a technical edit but a consistency edit 14:23:37 me and git... little rocky. 14:23:38 annegentle, it'S in the wiki - but I can sent you my scripts for backports as well... 14:23:41 Sam-I-Am: AJaeger: tell me if this makes sense, but I think just one person should do the back and forth? 14:23:44 annegentle: how does it work, O'reilly makes edits on feature/edits themselves, or should the doc team do the modifications? 14:23:45 Sam-I-Am: heh me too 14:24:05 gpocentek: we wanted O'Reilly to make edits on feature/edits themselves, but he apologetically sent an annotated PDF :) 14:24:11 ok :) 14:24:34 annegentle: if one person handles the back-and-forth, can multiple hand the edits? 14:24:37 Yeah, best if one person does it. 14:24:40 gpocentek: and I might go ahead with your abandoned edits since it seems like we still have time to get stuff over 14:24:41 annegentle: does it makes sense to merge the beginning of a patch I made then? 14:24:46 AJaeger: ok 14:24:56 gpocentek: yeah, just what I was thinking! mind reader :) 14:25:00 :) 14:25:46 I know the goal is to release in March so it's aggressive and I'd rather distract just me, though, rather than a lot of people... there's enough release doc work to go around. 14:26:04 gpocentek: so that was my thinking ^^ was avoiding distractions 14:26:21 * annegentle deflects distractions! 14:26:27 Any questions on that? 14:26:44 #topic Proposals for OpenStack Summit due 2/14, Design Summit tracks will be set in April 14:26:47 annegentle: if you need help to apply O'Reilly suggestion I can find some time 14:26:54 gpocentek: thanks much. 14:27:08 gpocentek: I just might need to take you up on that :) 14:27:14 gpocentek: so far so good 14:27:29 So, the Summit proposals are due this Friday 14:27:37 last Summit there were 600 proposals 14:27:37 annegentle: ok, feel free to ping me any time 14:27:56 These proposals are not for the Design Summit where we decided what to work on next release 14:28:08 Those I'll be asking for about a month ahead of the Summit. 14:28:15 The Summit is May 12-16 in Atlanta, GA 14:28:27 (Yes I realize the US Mother's Day is the Sunday before) 14:28:29 I feel like I'm juggling 600 proposals right now just from Mirantis. (JK) 14:28:34 nickchase: heh I believe it 14:28:57 dianefleming and I are proposing one in the Community Building section about the Documentation community and how we operate 14:29:10 Seems like each Summit I get asked if I proposed one about docs so there it is! 14:29:17 \o/ 14:29:18 :) 14:29:21 Many thanks to dianefleming for the outline. Really she does all the work around here. 14:29:22 annegentle, dianefleming: Great! 14:29:27 do we just talk about how cool this team is? 14:29:32 Sam-I-Am: heeh yes 14:29:36 Sam-I-Am, a group hug ;) 14:29:37 ha ha - 14:29:41 yeah right!!!! :) 14:30:41 talks about our meetings, book sprints, what works well, what's difficult 14:30:42 happy hug day to all the team mates :) 14:30:42 All of it! 14:31:21 chandan_kumar: :) 14:31:42 Ok that's all I've got on the Summit. 14:32:00 Well other than to strongly encourage docs team to apply for the Travel Program 14:32:20 #link https://wiki.openstack.org/wiki/Travel_Support_Program 14:32:44 @annegentle we should definitely get short bios and pictures of everyone on this team to include in our presentation! 14:32:52 dianefleming: that's a great idea! 14:33:51 dianefleming: let's see if it gets accepted :) 14:33:56 dianefleming: before doing a ton of work. 14:34:01 yeah! 14:34:07 WE should all vote for it once voting is up ;) 14:34:14 Although, this preso can be reused a bunch for Write the Docs and Open Help 14:34:20 AJaeger: :) 14:34:35 #topic API Docs blueprint updated 14:34:44 #link https://wiki.openstack.org/wiki/Blueprint-os-api-docs 14:35:00 so remember how we were gonna move all the -api docs into the /doc location? 14:35:11 we've updated the blueprint to not do the move this release 14:35:29 dianefleming: any other details you want to be sure people know? 14:35:54 nothing i can think of - just that it's a work in progress, with some of the work happening now and the completion happening in juno 14:36:22 but the effort is serving to clean up the API docs in general - it's having a good effect overall (i think) 14:37:11 dianefleming: yeah sounds right. And YES on the cleanup. 14:37:25 dianefleming: lots of improvement this release. A LOT. 14:37:44 Okay any API docs Qs? 14:37:47 thanks, and big thanks to AJaeger for all the gating work he did for APIs 14:37:55 yes 14:38:02 absolutely AJaeger! 14:38:08 yes... lots of work 14:38:15 The gating work showed a lot of problems that dianefleming had to fix ;) 14:38:32 So, we kept each other busy - thank! 14:38:33 always that tension between quality testers and the people making stuff!! 14:38:34 ha ha - yes true - but i wouldn't have known about that without the gates 14:38:52 and now I don't see it coming in again... 14:39:29 #topic Giveaways: Oxygen licenses are available, Travel Program for Summit, and Write the Docs in Budapest 14:39:42 Okay, just want to be sure people know about the stuff you can get! 14:39:49 I mentioned the Oxygen licenses earlier 14:39:54 and the Travel Program 14:40:08 So also wanted to say we have a free registration for Write the Docs. 14:40:14 #link http://conf.writethedocs.org/eu/2014/index.html 14:40:22 AJaeger: is that anywhere near you? 14:40:32 it looks like a great conf 14:40:33 I sat and watched nearly ALL the videos from the last Write the Docs 14:40:48 loquacities: yes! Rackspace is a sponsor 14:40:56 i saw :) 14:41:33 annegentle, depends on your definition of near - for me its too far ;) 14:41:44 AJaeger: yeah I have those same definitions :) 14:41:49 close than we are 14:41:51 closer 14:41:59 Ideally we'll get some passes for the Portland one too 14:42:30 Jamie Hannaford, a PHP dev on the same team as Diane and I, will be in Hungary 14:43:14 Ok, want to leave time for install doc talk! 14:43:17 #topic Installation guide updates for Icehouse 14:43:23 Sam-I-Am: sounds like you've had some good progress! 14:43:24 woooo 14:43:35 yeah, had some meetings with nick and phil 14:43:42 primarily trying to work out the networking stuff 14:44:04 in order to make networking fit best, some other parts of the doc could use some rearrangement 14:44:27 i finally have a working installation of icehouse on havana with nova-net 14:44:58 Yes, Sam-I-Am has doen a great job 14:45:07 so far the steps arent too different from havana. however, i would really like to find someone who can explain what really needs to be in the [keystone_authtoken] section of each service config file 14:45:09 We have a blueprint of the changes we want to make. 14:45:09 applause for Sam-I-Am 14:45:15 seems to be magical undocumented goodness 14:45:36 nice work Sam-I-Am 14:45:45 also a few questions about the v3 identity api because keystone now claims v2 is deprecated, but v3 doesnt seem to work. 14:46:19 my next step is trying to get neutron/ml2 working on icehouse/ubuntu 14:46:20 Sam-I-Am: I've been bugging dolphm about it 14:46:27 annegentle: thx 14:46:37 Sam-I-Am: there's no support for v3 in their client as I understand it 14:46:45 in addition to fixing networking, i'm trying to un-cruft the install guide 14:46:46 Sam-I-Am: I think they can't deprecate v2 yet 14:46:59 the good news is i havent needed to edit a single .ini file yet :) 14:47:21 Sam-I-Am: whoohoo 14:47:49 Sam-I-Am: oh I had another thought about swift/keystone 14:48:08 the networking party also decided we'd get the install guide done first, then work on the cloud guide and book 14:48:10 Sam-I-Am: I think that people will want that arch in, but it shouldn't need much more than testing for icehouse 14:48:17 Sam-I-Am: so that hopefully isn't much 14:48:26 Sam-I-Am: sounds good 14:48:32 annegentle: so swift without any other components? 14:48:56 nickchase, do you have a link handy for the blueprint? 14:49:11 #link https://wiki.openstack.org/wiki/Documentation/InstallGuideChanges 14:49:20 Sam-I-Am: swift and keystone only... thing is, you don't get a dashboard without horizon/nova I think 14:49:36 annegentle: how many people do that? 14:49:40 I want to get the existing structure in there and then will be sending it over the to ML in case people have feedback before we start moving things. 14:49:42 Sam-I-Am: right now we "add swift" with our install guide 14:49:49 Sam-I-Am: lots of people, storage is that entry point 14:50:01 Sam-I-Am: adding swift means that the dash works 14:50:35 annegentle: hmm, i'll have to see where we can fit a "lite" swift chapter 14:50:50 Sam-I-Am: it's also fine to leave it how it is, as additive 14:50:57 Sam-I-Am: just don't want it to get lost is all 14:51:23 we'll find a place for it... and an arch... somehow. 14:51:26 any questions about install, networking, storage, anything? 14:52:16 looks pretty quiet :P 14:53:16 * AJaeger just read the wiki page - I like where this is going! 14:53:16 #topic Docs core, docs team 14:53:29 I wanted to follow up on the email I sent to the list about docs core 14:53:33 Great, thanks AJaeger! 14:53:38 thanks a 14:54:15 wanted to emphasize that we don't have to have a super large core, and core is about reviews more than anything 14:54:17 * AJaeger looks forward to more reviewers ;) 14:54:26 AJaeger: yes :) 14:54:33 * loquacities has been putting more effort into reviews this week 14:54:38 i slacked off last month ;) 14:54:40 * Sam-I-Am tries to review more... but doesnt necessarily understand everything 14:54:42 I also realize I should trim out docs core for those who aren't really reviewers any more 14:54:53 loquacities: you've been doing great reviews! 14:55:00 aww, thanks :) 14:55:04 hopefully they're helpful 14:55:22 and dianefleming i've been meaning to say sorry for being so nitpicky! 14:55:27 I still don't really want to go to a ML vote -- I like how infra runs theirs with small growth rate, but that can change for sure! 14:55:32 And I do appreciate all the input... 14:55:38 and I probably will change my mind about votes eventually... 14:55:44 heh @ diane reviews 14:55:49 loquacities, sure! 14:55:58 nit-picky? ha! you're talking to the queen of the nit-pickers! 14:56:09 hehe, at least we're on the same page ;) 14:56:09 LOL 14:56:12 so to speak :P 14:56:28 on the same page with the same red pencil! 14:56:33 \o/ 14:56:42 'drive-by-diane-ing' - when you have a few +1s and out of nowhere comes a -1 for a period or comma somewhere :P 14:56:42 hee hee hee so true 14:56:52 LOL 14:56:52 HA! 14:56:54 I agree, we need active reviewers - and those that are in core and don't want to review anymore, should be asked to either step up or leave... 14:57:05 ha ha ha - i'm a little slow to the game, and then i like to crash into things! 14:57:07 AJaeger: yeah 14:57:16 i always fear the -1 14:57:20 Sam-I-Am, especially in a paragraph taht you didn't touch at all ;) 14:57:25 AJaeger: lol yeah 14:57:30 ohh, i'm good at those 14:57:44 also, I took from the 90-day list of reviewers, looking for longer-term knowledge of the docs state 14:57:49 "I know you didn't edit this bit, but i just noticed this crime against English grammar ..." 14:57:52 we lost our other drive-byer... nermina 14:58:03 so sad to lose nermina! 14:58:08 she still lurks 14:58:11 :'( 14:58:29 Believe me, nobody misses her more than I do. 14:58:36 We did hire a new writer 14:58:38 nickchase: hope you're hiring! 14:58:49 fresh blood! 14:58:52 nickchase: great, let us know if you want any help onboarding/training 14:58:53 nickchase: when is the hazing? 14:58:55 I'm shanghia -- I mean introducing her to docs tomorrow 14:58:57 lol 14:59:00 :) 14:59:09 heehee 14:59:10 nickchase, great! 14:59:12 Okay onward! 14:59:13 "we shall -1 your patches for tiny things for a month" 14:59:19 #topic Open discussion 14:59:23 well for one minute :) 14:59:29 better make it quick ... 14:59:39 hee 14:59:42 still having a blast working with y'all 14:59:46 +1 14:59:52 keeps me sane 14:59:52 We are working towards developer.openstack.org, where SDKs will live 15:00:00 so stay tuned for more user-dev oriented work 15:00:15 Sam-I-Am: awesome! 15:00:22 Sam-I-Am: your energy has been great! 15:00:32 yes, indeed :) 15:00:45 we just have to forbid him from working weekends. :) 15:00:47 ok better give up the meeting room, thanks all! 15:00:49 #endmeeting