14:00:35 #startmeeting docteam 14:00:36 Meeting started Wed Apr 22 14:00:35 2015 UTC and is due to finish in 60 minutes. The chair is annegentle. Information about MeetBot at http://wiki.debian.org/MeetBot. 14:00:38 Hi) 14:00:38 Useful Commands: #action #agreed #help #info #idea #link #topic #startvote. 14:00:40 The meeting name has been set to 'docteam' 14:00:42 Here's our agenda 14:00:44 #link https://wiki.openstack.org/wiki/Meetings/DocTeamMeeting#Agenda_for_next_meeting 14:00:46 Hi! 14:00:48 o/ 14:01:01 hi! good group! 14:01:10 Ok, first order of business 14:01:14 #topic Action items from last meeting 14:01:25 asettle to investigate first week of june for another APAC openstack docs f2f 14:01:29 haven't heard if that went thru 14:01:35 Lana to report back on i18n RST issues 14:01:42 we've worked that through I believe 14:01:52 Lana to change meeting schedule to alternating weeks -- but really we'll discuss :) 14:02:10 from the prior week 14:02:12 annegentle to patch openstack/governance to show move 14:02:14 Done 14:02:22 that was for the security guide 14:02:25 or did I? Hm. 14:02:32 annegentle to give latest Security Guide PDF link to Foundation to upload to Lulu 14:02:36 I'm working on that with Stefano 14:03:10 Ok I think I still need to patch openstack/governance to show move of security 14:03:11 doc 14:03:46 #action annegentle to patch openstack/governance to move security-doc to that team 14:03:59 #topic PTL changes: Anne will complete Kilo, Lana is planning Liberty 14:04:15 Really that is more of "info" than anything, to be sure you all know who to go to for what until April 30th 14:04:37 any questions about that? 14:04:58 #topic Kilo tasks 14:05:32 So, the RST publishing is complete, except for the .htaccess redirects, which are in progress in a patch 14:06:14 We're having a bug triaging day tomorrow, Thursday. Along with a Networking Guide doc day, same day. 14:06:20 heloooo 14:06:24 morning! 14:06:27 #topic Docs specs in review 14:06:42 Lana has a work-in-progress spec for the User Guide for Liberty 14:06:44 annegentle: bus timing issues 14:06:49 Sam-I-Am: understood 14:06:59 And the Training team has a bunch of specs they need to review 14:07:04 Anyone here from training? 14:07:22 annegentle, could you ping sarob to comment on the specs, please? 14:07:27 #info Training team needs to review their specs in the docs-specs repo 14:07:37 AJaeger: Lana and I both have more than once :) 14:07:42 ;( 14:07:57 he's transitioning jobs and it's hectic but other team members need to get on it to fill in 14:08:11 annegentle, let's consider abandoning them... 14:08:11 I think we talked about this next topic last time, but we can talk more if needed 14:08:18 AJaeger: well, that's one idea 14:08:26 AJaeger: or they need training-specs? 14:08:34 AJaeger: not sure their plains 14:08:36 er, plans 14:08:47 #topic Next migration project 14:08:48 since they're not here, let's not discuss further 14:08:53 #link https://docs.google.com/spreadsheets/d/10HD6iW1CtfB1qT2wVODYiHdC0ysr4xw392VCqHB-aaY/edit?usp=sharing 14:09:06 Like I said, I think that we discussed last time 14:09:15 please include translators in this discussion 14:09:19 but wanted to be sure its on everyone's radar, the data behind it 14:09:48 hello 14:09:48 AJaeger: ah yes. 14:09:49 hey dguitarbite 14:10:01 dguitarbite: I'll circle to you when we go through specialty teams 14:10:21 AJaeger: so is the action for Lana to reach out to translation? (It's a Liberty thing to me) 14:10:24 sure, I have nothing in particular. Thanks. 14:10:45 annegentle, agreed 14:10:47 AJaeger: ok 14:10:53 Let's go through specialty teams 14:11:03 #topic HA Guide - Needs an updated spec 14:11:23 Anyone here know if a spec is in the works? I know nickchase is away from computer for a bit 14:11:39 * AJaeger hasn't seen one materialize yet ;( 14:11:42 right 14:11:47 we'll leave it on as a reminder :) 14:11:59 #info HA guide needs an updated spec proposed to docs-specs 14:12:12 i havent been in the ha meetings lately 14:12:14 Anything else on ha guide? 14:12:14 too much.. kilo 14:12:23 Yeah it's a secondary priority for sure 14:12:31 #topic Training Guides 14:12:44 dguitarbite: we were wondering if you have someone who can clean up all the specs in docs-specs 14:12:56 Lana and I have asked Sean a few times 14:13:05 annegentle: training guides specific? 14:13:10 dguitarbite: yep 14:13:39 dguitarbite: five of them 14:13:53 #link https://review.openstack.org/#/q/project:openstack/docs-specs+status:open,n,z 14:13:55 yes, I will bring this up in next meeting 14:14:09 dguitarbite: thanks much appreciated. I know you all too are focused on Kilo/Summit 14:14:09 by clean ups do you mean deleting the old specs? 14:14:17 dguitarbite: whatever you guys think is right 14:14:24 or just update the status 14:14:35 dguitarbite, deleting or giving lots of positive air ;) 14:14:50 dguitarbite: mostly show they are being worked on 14:14:57 dguitarbite: or not, whatever the case may be :) 14:14:59 annegentle and myself can approve but will only do so if there's consensus 14:15:12 Ok, I think I get the gist of it. 14:15:37 AJaeger: dguitarbite: and we can talk about you guys getting your own specs repo if you are thinking of proposing a separate project, haven't heard if that's on your road map 14:15:55 But that's Liberty timing so really Lana can guide 14:16:04 #topic Install Guides - RST conversion convo 14:16:22 So I have status reports from Karin, Matt, and Christian as she was tripled booked this morning 14:16:26 annegentle: would it be good time after the first slides are published? 14:16:43 hello 14:16:46 then we may have more time to focus on having a new repository and be a separate project 14:16:46 dguitarbite: not sure what you are asking, good time for? 14:16:51 dguitarbite: ah ok 14:16:54 annegentle: she sent our e-mails to you? 14:16:57 Sam-I-Am: yes 14:17:19 annegentle: you are asking if its a good idea to gradute training guides 14:17:22 cool, so you know what's up 14:17:24 if I am correct 14:17:34 dguitarbite: I don't know your plans 14:17:42 annegentle, re: HA Guide... spec is in progress. hoping to submit by EOW 14:17:44 dguitarbite: that's all 14:17:49 mattgriffin: ah good, thanks! 14:17:52 yw 14:17:57 making lots of progress, although i havent seen a patch to make rhel/sles use apache with keystone, so i'm wondering how people are actually testing things 14:18:45 ok 14:18:56 Sam-I-Am, worked fine the old way for me ;) 14:19:00 Sam-I-Am: Christian is at a customer site 14:19:07 AJaeger: keystone deprecated eventlet, so it has to go 14:19:25 AJaeger: annegentle: Lets catch up later on the ML about the status of training guides. 14:19:37 Christian said in his status that he has tested it 14:19:45 Sam-I-Am: it works fine the old way :) 14:19:47 it being Identity 14:19:49 for opensuse 14:19:58 deprecated things work 14:20:01 but are deprecated 14:20:11 the spec says we're avoiding deprecations 14:20:29 #link http://specs.openstack.org/openstack/docs-specs/specs/kilo/installguide-kilo.html 14:20:41 it is under mandatory 14:21:10 crickets : 14:21:11 :) 14:21:19 heh, yeah. 14:21:33 well, let's talk about whether this is the last release with all the distros in one set of files 14:21:36 no fixy, no publishy 14:21:44 then each distro could write their own spec 14:21:54 but for kilo it's all in one set of files 14:21:54 well, yeah, and no. 14:22:16 having different distros do different things sounds like a recipe for disaster when it comes to support 14:22:34 that's certainly a consideration 14:22:54 please one file, we can handle that easily if we exclude Debian ;) 14:23:09 pretty much 14:23:22 all of the openstack services should use the same configs regardless of distro 14:23:30 its the system-level stuff thats different 14:23:34 like... package names. 14:23:51 of course, if we go to a source-based install (ha ha) 14:24:07 Okay then we still need patches for rhel/sles to use apache with keystone 14:24:15 yep 14:24:17 #info need patches for rhel/sles to use apache with keystone 14:24:19 anything else? 14:24:32 Christian will circle back on nova-network and Object Storage testing by end of week he says 14:24:34 more testing of all the things, of course 14:24:41 there's still a blocker-ish bug with the ubuntu packages 14:24:55 oh one more thing 14:24:57 i need to test swift and ceilometer 14:25:03 #info please update https://wiki.openstack.org/wiki/KiloDocTesting with current status 14:25:09 yeah ^ 14:25:20 is sahara in scope or optional? 14:25:32 if there's packages for all the distros we can try to make it work 14:25:39 but i'm not familiar with it 14:26:03 so, if there's time, and we can find resources 14:26:05 sahara is part of the guide - but I consider it more optional 14:26:09 I think it is optional then 14:26:11 yep 14:26:12 same with trove 14:26:13 ok 14:26:16 thats been a disaster too 14:26:17 agreed 14:26:33 well, teams need to bring their own patches past Compute/Identity/Storage/Networking 14:26:38 I wouldn't reject a patch to remove trove and sahara from the install guide to reduce the scope of the guide 14:26:44 heh there's a hint 14:26:47 also: https://review.openstack.org/#/c/174723/ 14:26:51 can someone mergerate that mess? 14:26:59 its causing a lot of dependent patches 14:27:24 annegentle: involvement by those teams would be really helpful 14:27:28 Sam-I-Am, you can approve ;) 14:27:37 AJaeger: i rebased it, is that ok? 14:27:40 Sam-I-Am: merge it wouldja? :) 14:27:49 Sam-I-Am: yeah 14:27:51 didnt know i could do that if i messed with it 14:27:54 but ok, mergerating 14:28:00 I was wiating for you on that one - next time give at least a +1. 14:28:00 Sam-I-Am: sure, esp. at release time 14:28:09 Go ahead and +2A 14:28:11 done 14:28:18 lets see what it breaks 14:28:19 ok 14:28:24 #topic User Guides - IA of guides 14:28:29 Lana has a spec started as a WIP 14:28:47 Join in those weekly meetings with the Aussies if you're interested! 14:28:51 #topic Security Guide 14:29:02 I have been working on a print-ready PDF so that I can document the process. 14:29:15 Just waiting for word from that team when they consider it ready for another PDF on Lulu 14:29:46 I think it's close 14:29:53 #topic API docs 14:30:11 Diane has been going great gangbusters on patches, trying to get Compute v2.1 API docs in shape 14:30:15 it's a ton of work. a metric ton 14:30:20 annegentle, do you have the firstapp guide on your list to discuss for today? 14:30:38 No, but let's talk about it here, it's more-or-less API 14:30:52 * AJaeger fears to review her HUGE patches, they are soo many lines changed... 14:31:13 she has too many patches in flight and therefore quite often merge conflicts 14:31:15 AJaeger: I know... and you can tell she's debugging since she's commenting out the pom. 14:31:25 reviewing help would be apprecitated 14:31:27 yep, pinged her about all the rebases this morning 14:31:39 #info Reviewing help on api-site would be much appreciated 14:31:40 Yeah, missed that in some reviews I fear ;( 14:31:51 AJaeger: yeah it happened! but was caught and fixed 14:32:05 okay, on to the First App tutorial 14:32:08 The spec merged 14:32:11 regarding firstapp: Document is in and I've started cleaning up and gating on it 14:32:20 #link http://specs.openstack.org/openstack/docs-specs/specs/kilo/openstack-firstapp.html 14:32:28 AJaeger: great, thank you 14:32:32 I need some reviews on api-site for these 14:32:40 AJaeger: okay, I'll ask Diane as well. 14:32:55 I want to test the samples, and I'm slowwww :) 14:32:58 https://review.openstack.org/#/q/status:open+project:openstack/api-site+owner:%22Andreas+Jaeger+%253Cjaegerandi%2540gmail.com%253E%22,n,z 14:33:11 AJaeger: great! 14:33:21 #link https://review.openstack.org/#/q/status:open+project:openstack/api-site+owner:%22Andreas+Jaeger+%253Cjaegerandi%2540gmail.com%253E%22,n,z 14:33:37 #info Please review the First App tutorial 14:33:48 Christian wants to add php-cloud examples next 14:33:49 we need editors to go over the text as well, I'm concentrating on toolchain integration now 14:34:01 #info Needs text editing 14:34:04 AJaeger: got it 14:34:36 Okay anything else on API docs, First App? 14:34:49 We now have anchor links for each operation in the API ref 14:35:20 Such as http://developer.openstack.org/api-ref-image-v2.html#getImage-v2 14:35:38 #topic Networking Guide - Test & review 14:35:48 Tomorrow is their sprint day 14:35:54 Join in #openstack-sprint all day 14:36:07 i'm sprinting at the dentist 14:36:16 Any reports on that? You guys have done a good job communicating on the list 14:36:20 * AJaeger joins Sam-I-Am for an hour ;) 14:36:21 Sam-I-Am: ugh 14:36:25 AJaeger: ha! 14:36:33 we're trying to get the scenarios converted 14:36:33 I meant :( 14:36:45 they're really important to publish prior to the summit 14:37:00 Sam-I-Am: all of them? I thought a subset 14:37:10 annegentle: i'd like to see all of them published 14:37:22 but the most popular ones would help 14:37:33 DVR is a big deal, imho 14:37:39 since theres zero other documentation for it 14:37:44 Sam-I-Am: ok as long as people know what's top priority so they can organize their day tomorrow 14:37:55 there shouldn't be any open reviews at the momeent for the networking guide - so clean slate to send patches in ;) 14:38:05 annegentle: pretty sure we prioritized stuff at last week's meeting using an etherpad 14:38:10 Sam-I-Am: ok, cool 14:38:27 also the draft publishing thing is very useful 14:38:31 #link https://etherpad.openstack.org/p/networking-guide 14:38:46 #info Please sign up for work on the Etherpad at https://etherpad.openstack.org/p/networking-guide 14:38:51 looks like no one's converted the DVR scenario :/ 14:39:22 ok 14:39:39 so that should be prio #1 for thursday 14:39:59 i'm going to try to write scenario 4b if i get time 14:40:06 it should be sort of easy 14:40:13 ok 14:40:17 added a note to the etherpad 14:40:38 #topic Doc tools update: use 2.1.4 clouddocs-maven-plugin for Kilo 14:40:52 I think I've patched all our guides that use clouddocs-maven-plugin to use 2.1.4 14:41:02 it's tiny changes so hopefully we don't have any problems 14:41:16 annegentle, trove as well? 14:41:39 AJaeger: I met with laurelm this week and she's going to take a look, but I didn't change their version, no 14:42:02 if she's aware, that's ok... 14:42:14 AJaeger: hm, not really, I'll follow up 14:42:24 you know trove is the only python project that uses clouddocs-maven-plugin 14:42:38 #action annegentle to check with trove team and Laurel about their WADL/Docbook guide embedded in trove repo 14:43:04 AJaeger: yeah, they want their devs to review it, which is great and all, but not sure if they have other integrations that mean it needs to stay there. 14:43:17 #topic Vancouver Summit 14:43:28 #link https://etherpad.openstack.org/p/Docs_Liberty_Design_Sessions 14:43:41 #link https://docs.google.com/spreadsheets/d/1VsFdRYGbX5eCde81XDV7TrPBfEC7cgtOFikruYmqbPY/edit?usp=sharing 14:43:57 Please add your needs for in-person discussion to the Etherpad 14:44:07 Also, Lana has proposed a cross-project Docs session 14:44:13 The schedule is the second link 14:44:25 and Lana is following up with Tom about the Operators session, the goals there, and so on. 14:44:39 Sam-I-Am: do you think an ops docs session is useful at the summit? 14:44:53 Sam-I-Am: I wanted to hear from you since you were at the ops midcycle 14:45:13 annegentle: yes 14:45:21 annegentle: there's definitely things they want to see 14:45:34 what i'd really like from ops is "here's how you should really do this" scenarios 14:45:38 Sam-I-Am: but is it a session like "hey you do this" instead of "how do I help?" 14:46:14 know what I mean? 14:46:20 ehhh 14:47:00 thinking... 14:47:05 i think its a little give and take 14:47:13 So far the title is just "Docs" ha ha ha 14:47:43 like... people who actually use openstack, are there any things the docs could do better... and we'd like some volunteers to help 14:47:47 like the HA guide, for example 14:48:10 perhaps case studies "we do this, here's why" 14:48:16 ok 14:48:19 contributions to the architecture guide 14:48:24 right 14:48:29 things that new people can read and get ideas without having to reinvent the weel 14:48:32 wheel 14:48:38 I'll let Lana and Tom sort it out to get the right people there. 14:48:45 one thing i recall from the ops meetup is everyone does everything differently 14:48:46 Sam-I-Am: +1 14:48:55 for sure. 14:49:19 There's a lot of need for things like "yes, you can do it *that* way, but it's a bad idea, because X" 14:50:10 getting people who actually use openstack to contribute back is a Good Idea 14:50:23 hell, i dont run any production installs :) 14:50:38 and getting a feel for "at what size does X stop working well" 14:50:53 +1 14:50:59 as long as those things are maintained 14:51:01 stale docs suck 14:51:04 Yes 14:51:07 double +1 14:51:10 we have plenty of those 14:51:15 it's in a tough area though 14:51:22 with the expansion of many services. 14:51:24 it's a lot of work. 14:51:49 but, I think it's valuable 14:51:49 so I'm not pushing back, of course we want more docs contributors, but we may need to descope the docs themselves and find another way to have people self-publish 14:51:56 Lana will have to sort it out 14:52:09 #topic APAC Meetups 14:52:20 Not as relevant to this side of the world, but check out two swarm dates 14:52:27 #info Planning for an APAC OpenStack meet up in May, ping asettle 14:52:32 they appear upside down to me 14:52:34 #info Planning for APAC Docs Swarm on 17-18 August 14:52:44 #topic Meeting time: switch to alternating weeks (rather than 1/3 and 2/4) 14:52:58 So apparently that's called fortnightly :) 14:53:13 calendaring systems have a much easier time with every-other 14:53:17 yep 14:53:25 and the fifth week months won't throw us off 14:53:31 i've missed the docs meeting quite a few times because calendar 14:53:33 so I can't think of any objections 14:53:48 we will need to find someone awake in this timezone to run these, Lana can't run both 14:54:00 That'll probably happen in May 14:54:10 #topic Open discussion 14:54:17 Anything else? 14:54:18 The WTE group publishes a calendar 14:54:29 WTE? Not familiar 14:54:36 which I subscribe to, but to the accurate docs point, some of them are inaccurate 14:54:39 Win The Enterprise 14:54:51 annegentle: of course you still want to run the meetings :) 14:54:57 annegentle: just like lana ran the apac ones 14:55:01 It's a google cal: https://www.google.com/calendar/ical/openstack.org_c3rclpidijlk4tma0vn0cbajrk%40group.calendar.google.com/public/basic.ics 14:55:34 Sam-I-Am: not in my todo list, it's being filled with all sorts of other fun stuff 14:55:46 ah got it egon 14:57:34 Okay, then! 14:57:37 Thanks all for attending. 14:57:43 #endmeeting