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