16:00:40 #startmeeting docteam 16:00:41 Meeting started Thu Jun 1 16:00:40 2017 UTC and is due to finish in 60 minutes. The chair is asettle. Information about MeetBot at http://wiki.debian.org/MeetBot. 16:00:42 Useful Commands: #action #agreed #help #info #idea #link #topic #startvote. 16:00:45 The meeting name has been set to 'docteam' 16:00:52 o/ 16:00:54 #topic Roll call 16:01:00 hi! 16:01:03 o/ 16:01:04 sup 16:01:20 o/ 16:01:25 o/ Coming to represent the Cinder peeps. :-) 16:01:33 And here I was, worried we wouldn't have quorum 16:01:39 Looking at chicken pie recipes instead 16:01:40 :p 16:02:20 Mmmm, Chicken Pie sounds good. Guess I need to start thinking about lunch. 16:02:23 I'll wait until 5 past before I get going. 16:02:28 Yeah that was my thoughts today 16:03:14 o/ 16:03:19 Ahoihoi 16:04:09 Okay, let's start :) 16:04:09 #topic Action items from the last meeting 16:04:18 * asettle asettle to chat to rluethi about training-labs and guides future 16:04:24 rluethi: we didn't quite manage that, did we? :p 16:04:31 not that I know of. 16:04:47 well, there is always another chance. 16:05:00 Let's book in some time next week to chat? Just an IRC convo, but I can send you a cal invite so at least we both know :) 16:05:06 That sound alright? 16:05:11 deal. 16:05:17 Done! 16:05:20 o/ 16:05:21 I'll keep that action item though 16:05:29 #action asettle to chat to rluethi about training-labs and guides future 16:05:36 * asettle asettle and ianychoi to discuss planning changes with translation activities 16:05:42 This, we also did not do, did we ianychoi ? :p 16:05:55 asettle, we have the same memory :) 16:06:05 o/ 16:06:09 Hahaha good good. Okay. Well. Let's also book in some time to talk this week :) how does that sound? 16:06:11 amotoki: welcome :) 16:06:22 Pretty cool! 16:06:33 Excellent, excellent 16:06:37 Will keep that action item up then 16:06:42 #action asettle and ianychoi to discuss planning changes with translation activities 16:06:48 #topic Count down to release 16:06:54 #link https://www.timeanddate.com/countdown/newyear?p0=24&msg=Pike+release&ud=1&font=slab 16:07:01 30 weeks LOL 16:07:06 But, that's coming up pretty damn fast 16:07:09 LoL (2) 16:07:15 I sent out a call for release managers today 16:07:22 If anyone is interested and can help out, I would really appreciate it 16:07:40 We need release help more than ever now. Esp considering our cores are continuing to dwindle 16:07:53 Anyone interested? 16:07:56 The releases always do seem to come out of nowhere . 16:08:17 We like to surprise you all with documentation 16:08:21 It's an incredibly boring surprise 16:08:21 asettle : what's involved in that? 16:08:26 :-) 16:08:31 dhellmann: +1 16:08:42 Without going into specifics too deeply 16:08:44 #link https://docs.openstack.org/contributor-guide/release.html 16:08:52 HEre's our overview 16:08:53 #link https://docs.openstack.org/contributor-guide/release/taskoverview.html 16:09:14 ok, I'll review those 16:09:18 It's mostly regarding the install guide testing, packages, CPL checks (we should add the doc-tag to that list) 16:09:36 Publishing branches, making sure the www stuff is up-to-date 16:10:08 I am planning/hoping before the end of Pike to get the docs bug mess in Cinder cleaned up a bit. 16:10:13 Previously, two people volunteer to help out. The PTL and the managers will meet, sync up, and make sure that all release items are all done :) 16:10:18 jungleboyj: woooo! :D 16:10:20 Love the sound of that 16:10:26 Do you need anything from us? 16:10:32 asettle: Thought you would. 16:10:46 I'm easily pleased. 16:11:08 asettle: No, going to come join your meetings here. Go through the bugs out there and do some cleanup / triage . I will bring you all questions as they arise. :-) 16:11:20 Wonderful :) well, welcome. Thanks for coming :) 16:11:27 Let us know what we can do to help you along the way :) 16:11:30 Happy to answer any questions 16:11:34 Discovered I like documentation while working on upstream-institute 16:11:36 I'm in the UK 16:11:47 Will do. 16:11:47 Well, I'm glad to hear that! 16:12:13 So, I will help those release items from that aspect. 16:12:21 That sounds great :) thanks. We appreciate that. 16:12:29 My pleasure. 16:12:31 Okay, well if nobody is going to jump at the opportunity to be release managers right this second, i'll move on :p 16:12:32 jungleboyj, wow more Docs-philic people :) 16:12:53 ianychoi: :-) Yep. You helped inspire me. ;-) 16:13:00 I have never heard of it being referred to as 'docs-philic' but I think that's hilariously great. 16:13:14 asettle: +2 16:13:26 jungleboyj, haha it's great pleasure. I also learned a lot from you during latest upstream institute! 16:13:38 :) 16:13:39 Aw :) 16:13:45 Okay team, let's keepa rolling 16:13:49 #topic Operations Guide 16:13:58 Some of you may have seen my emails that contained info about this 16:14:05 Here's my most recent email to the ops list 16:14:05 #link #topic Operations guide 16:14:07 Oh ffs 16:14:11 Copy pasta is hard 16:14:13 #link http://lists.openstack.org/pipermail/openstack-operators/2017-June/013633.html 16:14:30 TL;DR - we have three options for the future of hte ops guide, and I'm voting for option 3 16:14:32 I wanna hear what you all think 16:15:28 honestly this topic raises me a question what is a difference between admin guide and ops guide 16:15:30 asettle: option 3 means somebody needs to move it somehow in the wiki - so needs a volunteer and ownership 16:15:45 amotoki: +1 16:16:11 amotoki: well, that's what the session was about. We all very much came to the conclusion that the two guides, although one was technically more theoretical, and one more practical, they were both for hte same audience 16:16:24 Therefore, we decided that we had to go one of three ways with the guide's future 16:16:39 In the session, the operators agreed that we should do option 3 16:16:44 But I want to make sure the community agrees 16:16:49 And as AJaeger says - we get some volunteers to help this move 16:16:50 i see. that makes sense. 16:17:26 asettle: If it's pretty much the same subject, how will they differ going forward? 16:17:32 That seems sensible. An understandable division of the documentation. 16:17:47 rluethi: in content, or maintainability? 16:18:07 regardless of wiki or git repo, who takes ownership? ops team from UC? 16:18:10 Well, the email talks about where each guide lives, but how is the content different? 16:19:19 Ah, so, as I mentioned above - the main difference is mostly that one guide (ops) is more theoretical and concerns desiging, creating, and administratoring a production cloud 16:19:28 Whereas admin is more about managing and troubleshooting 16:19:46 Does that make sense? 16:20:02 I hope it does for the target audiences :). 16:20:06 asettle: The admin guide is more driven by development while the ops guide is driven by developers. RIght? 16:20:18 To me, it sounds like a difficult line to draw. 16:20:19 sorry 16:20:29 ops driven by operators 16:20:38 Haha yep, with that correction, yep 16:20:54 We still have the intention to move the Administration Guide out to the project repos for that reason 16:20:54 But.. such all migration from current ops-guide to Wiki would require huge effort - maybe creating a basic wiki for ops-guide (same table of contents, migrating just key content, and referring to current ops-guide in docs.o.o would be a first step? 16:21:12 :-) Yeah, minor detail. So, having the ops guide easily accessible to operators on the wiki and making admin guide closer to what developers are used to makes sense. 16:21:21 ianychoi: that's not a bad idea - we could then call for help? 16:21:30 jungleboyj: yep, that's pretty much my thinking 16:21:37 I probably haven't been clear enough in my email :/ 16:21:54 another option on ops-guide is to delegate core team. 16:22:03 What do you mean by that, amotoki ? 16:22:25 The challenge is going to be making the developers do it. :-) 16:22:35 jungleboyj: yo literally the story of my life 16:22:37 asettle: the wiki is not so easy to maintain. I believe gerrit review is really useful even for operators 16:22:40 My autobiography will be titled that. 16:22:57 amotoki: I completely agree with you. But we've struggled *so* much to get contributions from operators 16:22:59 THey dont' want to use gerrit 16:23:04 :-) 16:23:06 asettle, +1, because the most huge effort I think is that .rst syntax and MediaWiki syntax are not compatible. Migrating all the content may require long period.. 16:23:18 hehe, difficult choice :p 16:23:29 ianychoi: :-( 16:23:35 Hahhaha oh dear. 16:23:37 You're all very correct. 16:23:58 Hmm, anyway, let's see if I get any response from the ML - if not, I think we should make an executive decision. dhellmann - what would be TC appropriate protocol there? 16:24:31 asettle: I think we're in charge here, no need for TC IMHO 16:24:32 if you don't get a response, or if you don't have volunteers to do the work? 16:24:59 AJaeger: mostly just wondering if TC would have an issue with me going "okay, no responses, nobody cares, bye bye guide" 16:25:02 Can the work of moving to the wiki be split among the team here. Everyone take a section, reformat and move? 16:25:16 jungleboyj: we normally would do that, but we barely have a team as is :( 16:25:18 yeah, you don't need the tc to weigh in unless the decision is to mothball the guide 16:25:19 and then it's just a matter of going through the process 16:25:26 Coolio hoolio 16:25:30 What is "the process"? 16:25:50 jungleboyj : the whole point of this transition period is that there is not really a pool of people to do work like that 16:25:58 ^ what he said 16:25:58 asettle : let me find the doc, stand by 16:26:03 Swell, swell 16:26:38 asettle : https://docs.openstack.org/infra/manual/drivers.html#retiring-a-project 16:26:38 Ok. 16:27:00 #link https://docs.openstack.org/infra/manual/drivers.html#retiring-a-project 16:27:01 Just for later 16:27:04 Thanks 16:27:05 Okay 16:27:09 This is good info :) AJaeger ^ 16:27:29 On that note, I'll move to the next topic because it's related 16:27:33 #topic Docs team going forward 16:27:49 So, we're looking to gather as many volunteers to help us do a lot of heavy lifting in the coming months 16:27:57 So, I'm hoping we can all pool in and do some recruiting 16:29:25 It appears that from our ML discussion 16:29:26 #link http://lists.openstack.org/pipermail/openstack-dev/2017-May/117162.html 16:29:33 That we have chosen to go with option 1 16:29:40 "We could combine all of the documentation builds, so that each project has a single doc/source directory that includes developer, contributor, and user documentation." 16:30:02 We're going to need a really nice, special, helpful, person in infra to help us out :) 16:30:04 * asettle looks at AJaeger 16:30:30 * AJaeger is happy to review and advise - but cannot be in the driver seat 16:30:56 Sounds good - AJaeger could you help us recruit someone (or recommend?) we could talk to about driving this with us 16:31:03 I'll help with the build stuff, if AJaeger will help with reviews 16:31:19 AJaeger, regarding this, maybe translation build jobs also need to be unified for Documentation builds? 16:31:34 it should just be a matter of a new job that looks very much like the existing one, with a different publisher step, right AJaeger? 16:31:36 Hmm, would it affect translation? 16:31:47 good point 16:32:25 How integrated are the builds currently? 16:32:32 we already have translation jobs for the release notes. we can use those as the basis for new jobs. 16:32:35 dhellmann: yes. You need to figure out whether we still to "tox -e venv python setup.py build_sphinx" or run "tox -e docs" instead - and then how to publish 16:33:20 dhellmann, good point - yes all releasenote build jobs and AFAIK you, AJaeger, amotoki helped a lot 16:33:24 translations will be affected 16:33:26 but the translation script does a lot, so we might need to update it. I believe AJaeger and i can help it 16:33:54 ok. let's get the regular build stuff going and then add translations to it. 16:33:55 dhellmann: I'm happy to review 16:33:58 * dhellmann likes to work in phases 16:34:06 So, for the build changes - should we be looking at writing a spec, and then getting the plans nutted out a bit further? 16:34:16 dhellmann, amotoki. AJaeger: Thanks a lot all! 16:34:38 (I will follow such activities) 16:34:39 asettle: +1 it clarifies what's happening 16:34:47 Okay 16:34:54 #action asettle to write spec for build changes 16:35:22 I can help with that, too 16:35:31 Sweet, thanks dhellmann :) 16:35:37 #topic Speciality teams reports 16:35:42 annegentle: you around for the API report? :) 16:36:43 Guessing not at the moment :) we can come back 16:36:49 I can't see Matjaz either 16:36:55 rluethi: it's all you and the Training Labs :) 16:37:24 We merged a few patches for Windows hosts, and there are a few more under review or otherwise pending. 16:37:24 regarding the API ref, https://review.openstack.org/#/c/464255/ is proposing the addition of a new format. feedback would be appreciated. 16:37:25 patch 464255 - os-api-ref - WIP Add support for making sub-elements clearer 16:37:34 #link #topic Speciality teams reports 16:37:36 Thanks amotoki :) 16:37:41 rluethi: that's cool :) 16:37:44 New features will have to wait until that's done. 16:38:28 rluethi, cool for training-labs :) 16:38:45 I hope so :). 16:38:49 Wonderful :) thanks for the update rluethi 16:39:34 #topic Bug triaging 16:39:39 #link https://wiki.openstack.org/wiki/Documentation/SpecialityTeams#Bug_Triage_Team 16:39:46 Ben is our current bug triage liaison. Problems? 16:39:50 (not that I heard of) 16:39:55 I just pinged him, but he might not be around 16:40:00 Next up is Olga (ogusarenko) for the 5 Jun - 19 Jun 16:40:19 #topic Open discussion 16:40:26 Okay, we're at the end folks. I don't think I have much else. 16:40:40 I'm going to jump into the security team's meeting after this to talk about the Security Guide if anyone is interested 16:41:15 asettle: I just want to let the team know that I have volunteered to be the Neutron liaison here 16:41:23 mlavalle: wonderful :D thanks for coming along mlavalle 16:41:33 mlavalle: have you had a peak at the Networking Guide by any chance? 16:41:53 amotoki has been helping us out with a bunch of stuff, which has been awesome 16:41:54 asettle : which channel? 16:41:56 asettle: well, I look at different chapters every now and then 16:42:05 dhellmann: #openstack-meeting-alt 16:42:16 mlavalle: Okay cool :) well, john-davidge was pretty hands on! Which was great 16:42:20 I don't know if you have the time for htat? 16:42:34 mlavalle: this is useful for me https://review.openstack.org/#/q/status:open+project:openstack/openstack-manuals+path:%255Edoc/networking-guide/.* 16:42:35 :-) So we have an official Cinder and Neutron Liaison now. 16:42:47 Is there some place I should indicate that in the wiki? 16:42:51 Yessss 16:42:54 #link https://wiki.openstack.org/wiki/CrossProjectLiaisons#Documentation 16:42:56 I was just about to shoot htat ot you 16:42:58 that to you* 16:43:03 If you could both update, that'd be great 16:43:05 asettle: Thank you. 16:43:24 amotoki: am I stepping on your tows? Should you be the Neutron liaison? 16:43:24 Wellycomb 16:43:31 ^^^toes 16:43:59 mlavalle: np. it is yours. i have too many hats... 16:44:23 Done. 16:44:31 asettle: I have also too many hats. But this role was deemed important in a recent Neutron team meeting 16:44:57 mlavalle: asettle: we can share the loads. no worries 16:45:02 Thanks for helping, it is important :) the Networking Guide is a highly valued doc and we really appreciate all updates and maintenance the neutron team can offer 16:45:11 THank you both :) I really appreciate that 16:45:29 asettle: so I would like to get guidance from you and amotoki as to where help is critical 16:45:54 #link http://eavesdrop.openstack.org/meetings/openstack_i18n_meeting/2017/openstack_i18n_meeting.2017-06-01-07.18.html 16:46:00 So, amotoki was picking up where John left off on this bug: https://bugs.launchpad.net/openstack-manuals/+bug/1656378 16:46:02 Launchpad bug 1656378 in openstack-manuals "Networking Guide uses RFC1918 IPv4 ranges instead of RFC5737" [High,In progress] - Assigned to Chason (chen-xing) 16:46:04 #link https://bugs.launchpad.net/openstack-manuals/+bug/1656378 16:46:08 This is a high priority for us 16:46:19 asettle, I think PDF support for translated documents would be possible. :) 16:46:32 ah... the remaining part is to change IP address/cidr in figures 16:46:42 amotoki: ah wonderful! That's it?! 16:46:58 ianychoi: wonderful :D 16:47:11 I believe all stuffs in the rst contents have been clean up 16:47:22 Oh that's such good news! 16:47:23 Thank you amotoki :) 16:47:32 Okay, well, mlavalle that was a number one prio 16:47:37 I will post changes in figures in this month 16:47:39 But I would appreciate bug tackling: https://bugs.launchpad.net/openstack-manuals/+bugs?field.tag=networking-guide 16:48:06 asettle: ok, I'll keep an eye on that and will coordinate with amotoki 16:48:14 Also, I know John had some plans for improvements here 16:48:15 #link https://etherpad.openstack.org/p/networking-guide-improvements 16:48:17 one difficult thing is the netwokring guide sometimes use too many networks :( 16:48:24 True that 16:48:32 we sometimes use four networks... 16:48:37 Jeez :P 16:49:20 moving on ? 16:49:30 Hahha oh yes! Sorry, we're in open discussion 16:49:33 Anything from anyone else? :) 16:50:25 Okay! Let's close it out :) 16:50:28 Thanks for coming guys :) 16:50:45 Thanks! Enjoyed joining you all today. 16:50:46 See you 16:50:53 Thanks for coming jungleboyj :) 16:50:55 o/ 16:51:00 #endmeeting