00:31:26 #startmeeting docteam 00:31:28 muu? 00:31:28 Meeting started Wed Aug 24 00:31:26 2016 UTC and is due to finish in 60 minutes. The chair is loquacities. Information about MeetBot at http://wiki.debian.org/MeetBot. 00:31:29 Useful Commands: #action #agreed #help #info #idea #link #topic #startvote. 00:31:31 The meeting name has been set to 'docteam' 00:31:43 hi Sam-I-Am :) 00:31:46 who else is here? 00:31:54 yo 00:32:19 howdy 00:32:22 heya bmoss 00:32:27 o/ 00:32:42 do we have katomo around? 00:34:07 gosh, it's quiet 00:34:13 yeop 00:34:16 *chirp chirp* 00:34:20 *sigh* 00:34:31 everyone is too busy testing the install guide 00:34:35 haha! 00:34:37 i wish ;) 00:34:52 uhhhh yeah :) 00:35:05 i'm in the middle of reorganizing the net guide deployment examples 00:35:17 gee, that sounds like an awful lot of fun :S 00:35:25 changing the format to building blocks, using instructional knowledge 00:35:32 this is a good thing 00:35:37 adding things like ipv6 00:35:40 its all sorts of fun 00:35:43 heh 00:36:15 I'm here, small delay 00:36:26 hi JRobinson__ 00:36:35 looks like we're not going to make quorum again, though :( 00:36:37 Hi loquacities 00:36:48 oh, hi katomo! 00:36:54 katomo, o/ hi 00:36:58 well, that's probably enough 00:37:15 #topic Action items from the last meeting 00:37:35 i can't see any 00:37:44 #topic Specs in review 00:37:50 #link https://review.openstack.org/#/q/status:open+project:openstack/docs-specs,n,z 00:37:53 there werent any from the last US meeting 00:38:01 Sam-I-Am: yeah, i just checked ;) 00:38:07 ok, so we have a couple of specs out 00:38:29 #link https://review.openstack.org/#/c/354093/ Use openstack command to replace other commands 00:38:33 This one from Allen is about the OpenStack cli client changes 00:38:46 and ti doesn't have a blueprint yet, right? 00:38:53 I suggested some specific examples are needed. 00:38:55 * loquacities needs to go through the blueprints again soon 00:38:57 Blueprint? one second 00:39:25 * loquacities holds 00:39:38 Just this one -https://blueprints.launchpad.net/openstack-manuals/+spec/use-openstack-command 00:39:43 this was created before the spec 00:40:03 oh cool 00:40:11 So you can see three patches down on this blueprint. 00:40:18 ah yes, i remember emailing him ;) 00:40:18 That's the work that started before the spec. 00:40:25 yep, all good 00:40:31 thanks JRobinson__ 00:40:49 #link https://review.openstack.org/#/c/348940/ Adds specification to improve glossary usage 00:41:03 this one has already well and truly started 00:41:10 there's a bunch of reviews out for it 00:41:34 loquacities, np, 00:41:45 and finally ... 00:41:53 #link https://review.openstack.org/#/c/336007/ Release notes guidelines 00:42:02 i think that one is ready to merge too 00:42:42 need +1 from Doug? 00:43:09 yeah, it's probably good to wait 00:43:18 ok 00:43:41 he hasn't looked at it since 5 july, so we might need to ping him 00:44:20 ok, anything else on specs? 00:44:33 That's likely all for now 00:44:37 cool 00:44:42 #topic Speciality teams 00:44:47 #link https://etherpad.openstack.org/p/Speciality_Team_Reports 00:44:56 #info install guide testing has started 00:45:11 #link https://wiki.openstack.org/wiki/Documentation/NewtonDocTesting 00:45:27 any reports from other speciality teams? 00:45:38 networking guide is getting some reorg 00:45:57 the big reorg patch backport to mitaka merged, along with the redirects 00:45:58 i appreciate you doing that, it's going to be great once it's done 00:46:07 now i'm working on the actual content 00:46:15 its a huge mess :) 00:46:25 Just for the User Guide - I've merged the spec, which had enough reviews, I created the blueprint, and I'm going to start editing for O release. 00:46:27 it's a neverending story ;) 00:46:36 cool, thanks JRobinson__ 00:47:18 shall we move on? 00:47:21 nothing from config/cli ref at this week 00:47:28 We'll see how much is ready by release date. As discussed, it will carry over to the next cycle. 00:47:29 ok, thanks katomo 00:47:37 JRobinson__: yeah, that's expected 00:47:48 #topic Countdown to release 00:47:59 #info 42 days to go! 00:48:07 so that's 6 weeks tomorrow 00:48:11 yeah, wtf heh 00:48:17 it goes so fast! 00:48:18 feels like we just did this 00:48:31 it seems like we're constantly doing this ;) 00:48:38 pays the bills, for now. 00:48:40 PTL elections will be up again soon, too :S 00:49:02 #link https://wiki.openstack.org/wiki/Documentation/NewtonDeliverables 00:49:16 the list is very close to complete 00:49:42 i think we've had a good release, so far anyway ;) 00:49:55 very soon i'll have to start planning release activities 00:50:10 well, the install guide is going to be interesting 00:50:17 true 00:50:31 on the upside, fewer projects this time around 00:50:49 well, for docs to test... sure. but the overall experience is bound to be pretty bad for people. 00:50:57 since we dont know what the projects are doing 00:51:11 yeah, it'll be interesting to see what the fallout is 00:51:25 in some ways, it'll be better because at least people can *find* install info 00:51:38 yes, but it also has to work 00:51:41 on the other hand, it might not be the quality they expect ... 00:51:43 yeah 00:51:52 prior to havana people could find install info too. it just didnt work. 00:51:57 lol 00:52:09 so we're more or less turning back that clock 00:52:27 there's no other way to document them all, though 00:52:33 we couldn't keep going how we were 00:52:52 well, we'd need to move to a source install to include all the potential big-tent projects without packages 00:53:11 we'd still have the same problem with trying to write it all, though 00:53:19 but source would definitely help come testing time 00:53:35 i wish the people who were vocal about package install would spend more time testing 00:53:43 anyway, we've drifted off topic 00:53:43 its interesting that no one sees the big picture that we need assistance from operators to rewrite the install guide using source 00:53:51 #topic Open discussion 00:53:55 the install guide is a Big Deal 00:54:09 we can't get operators to help with the ops guide, and they actually care about that book 00:54:26 it benefits everyone in openstack to have it work and support the widest variety of projects 00:54:45 i'll be at the ops mid-cycle this week 00:54:51 you and i know this, but to everyone else it's SEP 00:54:55 usually people seem interested, the nothing happens 00:55:00 cool, well, get on to them ;) 00:55:04 yeah, we've noticed that ... 00:55:16 we have the same problem in the ops session every summit 00:55:16 i'll be trying again, of course. 00:55:21 being the moderator for the docs session 00:55:24 thanks, it's much appreciateed 00:55:25 yay! 00:55:36 you and darrenc should get together beforehand 00:55:43 i think they're just so tied into their own deployments its difficult to find some to contribute upstream... i guess. 00:55:54 anyway, this has turned into an airing of grievances 00:55:58 was there anything from anyone else? 00:56:03 haha 00:56:06 what else is new :) 00:56:10 tis openstack 00:56:29 I don't have anything else to add. 00:56:36 ok, cool 00:56:38 no 00:56:42 thanks everyone for coming! 00:56:44 No, that's all :) 00:56:53 #endmeeting