13:01:21 #startmeeting DocTeamMeeting 13:01:22 Meeting started Wed Aug 28 13:01:21 2013 UTC and is due to finish in 60 minutes. The chair is annegentle. Information about MeetBot at http://wiki.debian.org/MeetBot. 13:01:23 Useful Commands: #action #agreed #help #info #idea #link #topic #startvote. 13:01:25 The meeting name has been set to 'docteammeeting' 13:01:32 #topic Action items from last week 13:02:15 roadnick to meet with Kersten to help through the WADL journey 13:02:26 Nick emailed his regrets that he couldn't attend so I don't know the status. 13:02:33 annegentle codify our reviewing policies - done 13:02:44 I do need to add that we don't require a bug for each patch submitted 13:03:10 #action annegentle to clarify for reviewing policy whether we require a bug per patch 13:03:17 Next action, sgordon propose more often meetings on -docs Mailing List - done. 13:03:25 Though sgordon is still out this week 13:03:47 But, the ical feed is updated to every other Tuesday, we're just here this morning because a few of us missed it yesterday so I rescheduled. 13:03:58 #topic Docs Boot Camp Sept 9-10 13:04:01 annegentle: the meeting time stays wed 1pm UTC ? 13:04:09 EmilienM: nope goes back to Tues 13:04:17 EmilienM: this is a one-time move 13:04:19 for this week 13:04:47 #link https://wiki.openstack.org/wiki/Docs_Bootcamp_2013 13:04:58 We have nearly 25 people signed up. Great turnout. 13:05:06 The wiki page has instructions for what you should have set up on your laptop. 13:05:18 The schedule is shaping up to be half learn/labs, half unconference where we put up a board for future discussions. 13:05:26 Mirantis is taping the sessions and we'll post after camp. 13:06:01 Any questions on Docs Boot Camp? 13:06:33 annegentle: are all listed installs applicable to all attendees? 13:06:35 welcome nerminamiller and summerLong! 13:06:41 hi! 13:06:48 hi! 13:06:53 nerminamiller: good question. I would consider the autodoc and publican to be optional 13:07:00 off the top of my head 13:07:21 thanks 13:07:39 I'm getting excited to come to California 13:08:02 figuring out lunch, dinner, entertainment. 13:08:12 Ok on to 13:08:15 #topic Admin guides 13:08:45 I put this on there just to let people know the latest for the four we're parting out, and to see how a larger one looks. 13:09:07 Block Storage is already done, config moved to config, install to install. 13:09:13 Object Storage is in progress. 13:09:47 Compute Admin is pretty well parted out to user guide and config guide but more work needs to be done to delete outdated content. 13:10:20 Network Admin Guide hasn't been pieced out but I did talk to emagana about what goes where. 13:10:29 nerminamiller: how's the larger guide looking? 13:10:52 nerminamiller: I haven't looked at the outline again since last week 13:11:03 annegentle: the matchup with the blueprint is almost done. 13:11:11 i took it offline to work on it. 13:11:23 hope to replace it by cob today. 13:11:25 nerminamiller: okie 13:11:47 nerminamiller: are you thinking the Compute Admin guide "becomes" the OpenStack Admin guide? 13:11:52 also considering merge with ops guide. will propose in more detail in the blueprint. 13:12:01 nerminamiller: or should I just wait for the blueprint :) 13:12:13 re: compute = yes 13:12:27 nerminamiller: ok good-o 13:12:32 And don't touch compute until you're done... 13:12:40 Just hit something with quotas... 13:12:53 summerLong: oh it'll merge! :) 13:12:56 summerLong: I think 13:13:08 summerLong: so who shouldn't touch compute 13:13:21 not touching a thing :) 13:13:25 But the question is whether quota info will remain? 13:13:32 summerLong: oh yes it needs a home 13:13:52 Is in admin user guide already. 13:13:57 summerLong: quotas and rate limiting I've seen in config ref too though, it's configuration. 13:14:37 Am doing xi includes from admin gd into project admin guides? 13:15:05 summerLong: the idea is to make the project admin guides super small so that they could be xi:included into a larger admin guide (I think, correct me if that's wrong) 13:15:30 summerLong: quota configuration is already out of the compute admin guide on the master branch 13:15:42 summerLong: and into the config ref 13:16:57 summerLong: is that crazy making? 13:17:06 Hmm, definitely 13:17:11 summerLong: oh dear 13:17:41 Is now everywhere. It's in the admin user guide already. Had finished chapters on those (updated) 13:18:06 No problem with it not being in the project guides of course. 13:18:06 summerLong: if it's modular it's easy to move right 13:18:13 Yes. 13:18:20 summerLong: ohhhh right the admin user guide 13:18:28 summerLong: yes it makes sense for quota setting to be in there 13:18:40 summerLong: nerminamiller is outlining yet another admin guide 13:18:50 summerLong: so what you've done should stay, yes. 13:18:58 this kind of confusion is what I'm afraid of 13:19:01 yes, the 'system' admin guide. 13:19:12 but -- I think there's good reason for an admin user guide 13:19:13 But would be good to have consistent info across guides. 13:19:18 nerminamiller: be sure to read what is in the admin user guide 13:19:22 summerLong: yes 13:19:25 will do 13:19:50 And I'll take a look at the config ref? 13:19:53 so. Admin User Guide = Covers user tasks performed through the dashboard and CLIs for admin users. 13:19:54 i'm looking at the ops as well 13:20:08 Administration Guide = Covers system administration tasks like maintaining, monitoring, and customizing an initially installed system. Could also be called "Cloud Administration Guide." 13:20:18 I'm using shortened titles which is bad. 13:20:21 Sorry y'all. 13:20:43 summerLong: the config ref has quota info in it now, about how to configure, so do try to consolidate as needed. 13:20:50 summerLong: good catch 13:20:57 Ok, will do. 13:21:04 We could also call the Admin User Guide the User Guide for Administrators. 13:21:16 Ok any more questions 13:21:32 on Admin Guides in all their glory? 13:21:44 yes, i had a question about name for user guide for admins - the title 13:21:58 dianefleming: sure 13:22:01 what do people prefer 1) Admin User Guide 2) User Guide for Administrators 13:22:23 I'm currently calling the regular User Guide -> End User Guide, but I could shorten to "User Guide" 13:22:41 so we would have User Guide and User Guide for Administrators 13:22:54 Hm... thinking 13:23:06 we can discuss on docs list later - just throwing it out there 13:23:17 Sort of liked the earlier pairing of End User and Admin User guides. 13:23:38 dianefleming: yeah it's a good question - I like Admin User Guide but I like shorter titles. 13:23:58 Hm, I thnk having a guide name that is a subset of another guide name not such a good idea. 13:24:02 I'm fine with End User Guide and Admin User Guide 13:24:13 poll users? 13:24:21 brucer: so no "User Guide for Administrators" 13:24:29 @brucer don't know what you mean 13:24:44 yeh, rather Admin UG and End UG 13:25:02 agree with brucer 13:25:04 that's fine - I'll do that 13:25:37 dianefleming: ok good, you can definitely tell the ML and then if anyone hollers we'd reconsider but I think Admin UG and End UG 13:25:48 #agreed Admin User Guide and End User Guide titles 13:25:54 ok, moving along 13:25:57 #topic Install guides 13:26:18 shaunm: I won't put you on the spot but I'll report what I know and you can chime in 13:26:39 ok 13:26:49 After several weeks trying to get some hardware from Cisco only to find out it is VMS they give out in their lab, shaunm is going to rig laptops for testing install instructions 13:27:11 basically, a laptop with a USB > Ethernet NIC added on works well for a 2 NIC "server" 13:27:23 it's what the Rackspace training group uses for portability 13:27:37 shaunm: you can add any other updates you have 13:29:13 There have been continual patches to the install guides 13:29:17 that's about it 13:29:24 even one came in yesterday that I'll backport to grizzly 13:29:31 shaunm: are you going to submit a patch this week? 13:29:51 shaunm: with a consolidated install guide? 13:30:50 yes, though probably not complete 13:31:10 shaunm: sure. 13:31:30 The install architectures are at https://etherpad.openstack.org/havanainstall 13:31:32 #link https://etherpad.openstack.org/havanainstall 13:31:37 any questions on install? 13:32:19 Ok, going to translation 13:32:30 #topic Translation builds 13:32:51 we do have a reply from daisy on the mailing list 13:33:12 sounds like they'd need a tools directory for each repository so that translated files can be sliced and built 13:33:30 Sounds like we still have work to do. 13:33:53 I'm also working with Todd Morey, a designer at the Foundation, to ensure we do a good job with other-language landing pages for docs. 13:34:10 Any questions on translation builds? 13:34:20 How many languages will be supported? 13:34:46 Ok, silly question. 13:34:51 How long is a piece of string. 13:35:04 summerLong: Long story, but basically we have the Ops Guide in Chinese and Japanese now 13:35:08 summerLong: heh 13:35:22 summerLong: well, yes, and also, the po files are available on Transifex for many many languages 13:35:37 summerLong: but we have 2 now 13:35:40 plans for any other languages? 13:36:21 nerminamiller: you say "plans" :) 13:36:38 :) 13:36:41 nerminamiller: if you look at https://www.transifex.com/projects/p/openstack-manuals-i18n/resources/ 13:36:59 nerminamiller: you can see that there are five full translations of the API Quick Start 13:37:13 Chinese, Russian, Korean, Portuguese, Vietnamese 13:37:20 Those are some of the most active language communities 13:37:26 But, that's also a very small guide. 13:37:50 Every Summit, we talk about their plans, I'm not saying it's not planned, just saying it's a huge coordination effort 13:37:55 and we try to enable as much as we can 13:38:05 while not slowing down English content dev. 13:38:07 Does that help? 13:38:20 thanks 13:38:31 Any more questions on Translation? It's good for us all to know about the moving pieces and parts. 13:39:21 Ok, onward 13:39:26 #topic Bugs and DocImpact 13:39:33 #link https://launchpad.net/openstack-api-site/+milestone/havana 13:39:52 #link https://launchpad.net/openstack-manuals/+milestone/havana 13:40:09 I don't put this topic at the bottom of the agenda to de-emphasize its importance :) 13:40:33 There are 217 bugs targeted for admin/config/end users, and 72 targeted for API docs. 13:40:38 These are serious numbers. 13:40:57 We've done a great job getting the info and making it into data with DocImpact. 13:41:09 So keep looking at what you can do for doc bug fixes. 13:41:29 And, recruit the dev who put DocImpact in the commit message to write docs. 13:41:41 +1 13:41:52 it's a matter of education :) 13:42:12 EmilienM: yep, and coaching to help them find the right place to put it now that we've done a lot of moving around. 13:42:24 sure 13:42:25 There are a lot of Fix Released on that list too 13:42:34 I'll try to knock out some of the api-site ones 13:42:41 dianefleming: ok thanks 13:42:57 i'll commit to some this week as well 13:43:06 There are only 5 or 6 Triaged so even if all you can do is put a comment saying what to do to fix the bug, that's a help 13:43:12 sure 13:43:16 will do 13:43:18 Triaged means someone else can fix the bug with the info in the comments. 13:43:32 Ok! Shall we go to Open Discussion? 13:43:38 #topic Open discussion 13:43:39 I would like to talk about openstack-ha guide 13:43:39 #link https://blueprints.launchpad.net/openstack-manuals/+spec/improve-high-availability-support 13:43:39 #link http://docs.openstack.org/trunk/openstack-ha/ 13:43:39 I did not make a good progress this summer, but I'm on it right now. 13:43:39 I'm currently working on https://bugs.launchpad.net/openstack-manuals/+bug/1196099 13:43:40 to bring neutron dhcp agent in HA, the doc is already here : 13:43:40 EmilienM: go ahead 13:43:41 Launchpad bug 1196099 in openstack-manuals "openstack-ha guide / Active-Active section: Miss Network section " [Wishlist,Confirmed] 13:43:44 #link http://docs.openstack.org/trunk/openstack-network/admin/content/demo_multiple_operation.html 13:43:47 my question is: can I give basic explaining and redirect to the neutron doc ? 13:43:49 :) 13:44:13 EmilienM: have you asked emagana if he's good with that? He's our doc liaison for Neutron 13:44:22 EmilienM: does the Neutron doc have HA info? 13:44:38 annegentle: I know him, I'm going to ping him 13:44:44 EmilienM: ok, good. 13:44:48 annegentle: as I say, yes; for DHCP only. 13:44:52 EmilienM: also is it known how to make neutron HA? 13:44:56 EmilienM: oh ok. 13:45:02 my second thing where I need help is that neutron does not provide yet active / active HA for some agents. You can run them by active / passive using Pacemaker / Corosync. So what I plan to do, is to write it in the active / passive sections, and document active / active in explaining that it's not supported yet, but they can have HA with active / passive (and refer to the AP section). 13:45:02 Make sense ? 13:45:17 EmilienM: what is your sense of whether multi-host will make it into havana for neutron? 13:45:36 annegentle: multihost is only for DHCP afik 13:45:42 EmilienM: Yes, I think it's best to indicate where active/active is NOT available 13:45:51 EmilienM: ok 13:45:55 annegentle: L3, metadata, lbaas aren't scalable yet 13:46:02 ok. 13:46:09 EmilienM: ok, and L3 is nearly always what users are after it would seem 13:46:13 everything is fine for me, let's go to work now :) 13:46:18 EmilienM: sweet 13:46:26 thx annegentle 13:46:37 I wanted to point out a Marketing portal is available 13:46:39 #link http://www.openstack.org/marketing 13:46:55 Also I'm attending once-monthly content meetings with Foundation staff, went to the first one last week. 13:47:22 Discussing what content needs created, prioritizing it and finding resources. 13:47:38 Last week was a chance to get to know each other, there were mostly company reps. 13:48:19 We should be getting first-run tshirts at docs boot camp, woo 13:48:41 I think that's it! Anyone else? 13:48:49 Nope 13:48:56 sarob: lurk! 13:48:58 :) 13:49:04 ;) 13:49:07 Ok take back 11 minutes of your day! 13:49:10 #endmeeting