*** matjazp has joined #openstack-doc | 00:00 | |
*** david-lyle is now known as david-lyle_afk | 00:14 | |
*** pdesai has quit IRC | 00:16 | |
*** wastrel has joined #openstack-doc | 00:16 | |
*** Piet has joined #openstack-doc | 00:20 | |
openstackgerrit | Anish Bhatt proposed openstack/openstack-manuals: Fix accidental change in neutron id https://review.openstack.org/159302 | 00:30 |
---|---|---|
openstackgerrit | Matthew Kassawara proposed openstack/openstack-manuals: Migration of l3ha-ovs scenario in Networking Guide https://review.openstack.org/158983 | 00:30 |
*** matjazp has quit IRC | 00:38 | |
openstackgerrit | Matthew Kassawara proposed openstack/openstack-manuals: [install-guide] allow guest access for rabbitmq https://review.openstack.org/159307 | 00:39 |
*** Marga__ has quit IRC | 00:41 | |
*** dmacpher has joined #openstack-doc | 00:43 | |
*** salv-orlando has quit IRC | 01:00 | |
*** xgerman has quit IRC | 01:09 | |
*** patrickeast has quit IRC | 01:22 | |
openstackgerrit | Darren Chan proposed openstack/openstack-manuals: Migration of cli sections in End User Guide https://review.openstack.org/157270 | 01:33 |
*** amalagon has joined #openstack-doc | 01:38 | |
*** asettle-mtg is now known as asettle | 01:39 | |
*** bdpayne has quit IRC | 01:43 | |
*** j1mc has joined #openstack-doc | 01:47 | |
*** koolhead17 has joined #openstack-doc | 02:17 | |
*** j1mc has quit IRC | 02:18 | |
*** darrenc is now known as darrenc_afk | 02:28 | |
*** j1mc has joined #openstack-doc | 02:42 | |
*** chlong_ has joined #openstack-doc | 02:43 | |
openstackgerrit | yuji hagiwara proposed openstack/api-site: Fix Incorrect parameters for Neutron Port APIs https://review.openstack.org/159323 | 02:47 |
*** stevemar has joined #openstack-doc | 02:49 | |
*** darrenc_afk is now known as darrenc | 02:51 | |
*** koolhead17 has quit IRC | 02:53 | |
*** Aish has quit IRC | 03:11 | |
*** JRobinson__ is now known as JRobinson__afk | 03:19 | |
*** coolsvap_ is now known as coolsvap | 03:33 | |
*** ddomingo has joined #openstack-doc | 03:37 | |
*** dmacpher is now known as dmacpher-lunch | 03:40 | |
*** rbowen has quit IRC | 03:42 | |
*** Aish has joined #openstack-doc | 03:44 | |
*** ddomingo has left #openstack-doc | 03:49 | |
*** JRobinson__afk is now known as JRobinson__ | 03:56 | |
*** jecarey has joined #openstack-doc | 04:30 | |
*** patrickeast has joined #openstack-doc | 04:33 | |
*** coolsvap is now known as coolsvap_ | 04:57 | |
*** patrickeast has quit IRC | 04:58 | |
*** chandankumar has joined #openstack-doc | 05:02 | |
*** coolsvap_ is now known as coolsvap | 05:04 | |
*** jecarey has quit IRC | 05:29 | |
openstackgerrit | Takanori Miyagishi proposed openstack/api-site: Fix a incorrect parameters for "Create/Update router" https://review.openstack.org/159005 | 05:31 |
*** amalagon has quit IRC | 05:36 | |
*** koolhead17 has joined #openstack-doc | 05:41 | |
*** egallen has joined #openstack-doc | 05:43 | |
*** wastrel has quit IRC | 05:47 | |
*** alisonholloway has quit IRC | 05:48 | |
*** steveg is now known as sgordon | 05:50 | |
*** sarob has quit IRC | 06:01 | |
openstackgerrit | OpenStack Proposal Bot proposed openstack/api-site: Imported Translations from Transifex https://review.openstack.org/159006 | 06:02 |
*** sarob has joined #openstack-doc | 06:03 | |
*** sarob has quit IRC | 06:08 | |
*** alisonholloway has joined #openstack-doc | 06:10 | |
openstackgerrit | OpenStack Proposal Bot proposed openstack/openstack-manuals: Imported Translations from Transifex https://review.openstack.org/159346 | 06:14 |
*** j1mc has quit IRC | 06:15 | |
*** adahms has quit IRC | 06:17 | |
*** dnavale has quit IRC | 06:23 | |
*** koolhead17 has quit IRC | 06:25 | |
*** fifieldt has joined #openstack-doc | 06:26 | |
*** sarob has joined #openstack-doc | 06:30 | |
*** sarob has quit IRC | 06:41 | |
*** chandankumar has quit IRC | 06:44 | |
*** Marga_ has joined #openstack-doc | 06:49 | |
*** Marga_ has quit IRC | 06:49 | |
*** Marga_ has joined #openstack-doc | 06:50 | |
*** chandankumar has joined #openstack-doc | 06:55 | |
*** egallen has quit IRC | 06:57 | |
*** JRobinson__ has quit IRC | 06:57 | |
*** sayali has joined #openstack-doc | 07:02 | |
openstackgerrit | Liu Xinguo proposed openstack/openstack-manuals: Update huawei driver configuration https://review.openstack.org/150761 | 07:06 |
*** bmoss has quit IRC | 07:08 | |
*** sarob has joined #openstack-doc | 07:13 | |
*** egallen has joined #openstack-doc | 07:14 | |
*** sarob has quit IRC | 07:18 | |
openstackgerrit | Merged openstack/api-site: Imported Translations from Transifex https://review.openstack.org/159006 | 07:20 |
*** ildikov has quit IRC | 07:21 | |
openstackgerrit | Merged openstack/openstack-manuals: Imported Translations from Transifex https://review.openstack.org/159346 | 07:21 |
*** sgordon is now known as steveg | 07:22 | |
openstackgerrit | yuji hagiwara proposed openstack/api-site: Fix missing parameters for Neutron security group API https://review.openstack.org/158939 | 07:25 |
*** egallen has quit IRC | 07:27 | |
*** suyog has quit IRC | 07:30 | |
openstackgerrit | Sayali Lunkad proposed openstack/training-guides: Modifies osbash files to use osbash ssh keys https://review.openstack.org/158668 | 07:33 |
*** Marga_ has quit IRC | 07:35 | |
*** chlong_ has quit IRC | 07:42 | |
*** chlong has quit IRC | 07:43 | |
*** Aish has quit IRC | 07:44 | |
openstackgerrit | yuji hagiwara proposed openstack/api-site: Fix missing parameters for Neutron security group API https://review.openstack.org/158939 | 07:45 |
*** egallen has joined #openstack-doc | 07:45 | |
openstackgerrit | Merged openstack/openstack-manuals: [install-guide] allow guest access for rabbitmq https://review.openstack.org/159307 | 07:54 |
openstackgerrit | yuji hagiwara proposed openstack/api-site: Fix missing parameters for Neutron security group API https://review.openstack.org/158939 | 07:57 |
*** ildikov has joined #openstack-doc | 08:09 | |
*** egallen has quit IRC | 08:09 | |
*** taroth has joined #openstack-doc | 08:10 | |
*** dmacpher-lunch has quit IRC | 08:12 | |
*** egallen has joined #openstack-doc | 08:28 | |
*** salv-orlando has joined #openstack-doc | 08:39 | |
*** stevemar has quit IRC | 08:57 | |
*** fminzoni has joined #openstack-doc | 09:01 | |
*** sarob has joined #openstack-doc | 09:14 | |
*** steveg is now known as sgordon | 09:16 | |
*** Aish has joined #openstack-doc | 09:17 | |
*** Aish has left #openstack-doc | 09:17 | |
*** sarob has quit IRC | 09:19 | |
*** jemangs_ has quit IRC | 09:32 | |
*** sgordon is now known as steveg | 09:32 | |
*** jemangs has joined #openstack-doc | 09:34 | |
*** salv-orlando has quit IRC | 09:49 | |
openstackgerrit | Alexis GUNST proposed openstack/openstack-manuals: Add Debian image default user https://review.openstack.org/159393 | 10:02 |
*** EmilienM|afk is now known as EmilienM | 10:11 | |
*** koolhead17 has joined #openstack-doc | 10:13 | |
*** sarob has joined #openstack-doc | 10:16 | |
*** steveg is now known as sgordon | 10:19 | |
*** sarob has quit IRC | 10:21 | |
openstackgerrit | Ildiko Vancsa proposed openstack/api-site: Add Samples endpoint to the Telemetry API Reference https://review.openstack.org/159177 | 10:23 |
openstackgerrit | Ildiko Vancsa proposed openstack/api-site: Add Capabilities endpoint to Telemetry API Reference https://review.openstack.org/159398 | 10:23 |
*** matjazp has joined #openstack-doc | 10:33 | |
*** egallen has quit IRC | 10:47 | |
openstackgerrit | Sayali Lunkad proposed openstack/training-guides: Modifies osbash files to use osbash ssh keys https://review.openstack.org/158668 | 10:59 |
*** matjazp has quit IRC | 11:11 | |
*** amotoki has joined #openstack-doc | 11:12 | |
*** salv-orlando has joined #openstack-doc | 11:15 | |
*** sarob has joined #openstack-doc | 11:17 | |
openstackgerrit | Darren Chan proposed openstack/openstack-manuals: Edits to the launch instances section https://review.openstack.org/159413 | 11:18 |
*** pcaruana has joined #openstack-doc | 11:19 | |
*** sarob has quit IRC | 11:22 | |
openstackgerrit | Darren Chan proposed openstack/openstack-manuals: Edits to the launch instances section https://review.openstack.org/159413 | 11:24 |
*** sayan has joined #openstack-doc | 11:39 | |
*** salv-orlando has quit IRC | 11:44 | |
*** chlong has joined #openstack-doc | 11:51 | |
*** chlong_ has joined #openstack-doc | 11:51 | |
*** matjazp has joined #openstack-doc | 11:51 | |
*** egallen has joined #openstack-doc | 11:52 | |
*** sgordon is now known as steveg | 12:02 | |
openstackgerrit | Christian Berendt proposed openstack/openstack-manuals: Update CLI reference for python-glanceclient 0.16.0 https://review.openstack.org/159433 | 12:08 |
openstackgerrit | Christian Berendt proposed openstack/openstack-manuals: Update CLI reference for python-ceilometerclient 1.0.13 https://review.openstack.org/159434 | 12:10 |
*** erlon has joined #openstack-doc | 12:10 | |
openstackgerrit | Christian Berendt proposed openstack/openstack-manuals: Update CLI reference for python-cinderclient 1.1.1 https://review.openstack.org/159435 | 12:17 |
*** annegentle has quit IRC | 12:33 | |
*** Harry51S has joined #openstack-doc | 12:34 | |
*** etoews has joined #openstack-doc | 12:49 | |
*** etoews has quit IRC | 12:51 | |
*** etoews has joined #openstack-doc | 12:52 | |
*** rbowen has joined #openstack-doc | 12:53 | |
*** salv-orlando has joined #openstack-doc | 12:54 | |
*** matjazp has quit IRC | 12:56 | |
*** fminzoni has quit IRC | 13:02 | |
*** fminzoni has joined #openstack-doc | 13:03 | |
*** fminzoni has quit IRC | 13:06 | |
*** fminzoni has joined #openstack-doc | 13:07 | |
openstackgerrit | Christian Berendt proposed openstack/openstack-doc-tools: [commands] fix generator for latest python-openstackclient https://review.openstack.org/159448 | 13:08 |
*** sayan has quit IRC | 13:10 | |
openstackgerrit | Christian Berendt proposed openstack/openstack-manuals: Update CLI reference for python-openstackclient 1.0.2 https://review.openstack.org/159452 | 13:11 |
openstackgerrit | Christian Berendt proposed openstack/openstack-doc-tools: [commands] fix generator for latest python-openstackclient https://review.openstack.org/159448 | 13:15 |
*** chlong has quit IRC | 13:20 | |
*** chlong_ has quit IRC | 13:20 | |
*** matjazp has joined #openstack-doc | 13:23 | |
openstackgerrit | Christian Berendt proposed openstack/openstack-doc-tools: [commands] fix generator for latest python-openstackclient https://review.openstack.org/159448 | 13:27 |
*** chandankumar has quit IRC | 13:27 | |
*** ildikov has quit IRC | 13:38 | |
*** etoews has quit IRC | 13:40 | |
openstackgerrit | Christian Berendt proposed openstack/openstack-doc-tools: [commands] fix generator for latest python-openstackclient https://review.openstack.org/159448 | 13:40 |
*** etoews has joined #openstack-doc | 13:42 | |
*** matjazp has quit IRC | 13:49 | |
*** ildikov has joined #openstack-doc | 13:51 | |
*** ildikov is now known as ildikov_afk | 13:51 | |
Sam-I-Am | mornings | 13:56 |
*** berendt has joined #openstack-doc | 13:57 | |
Sam-I-Am | mmmmeeting? | 13:59 |
AJaeger | morning, Sam-I-Am ! | 14:00 |
Sam-I-Am | hi | 14:00 |
AJaeger | Where's annegentle? | 14:00 |
*** etoews has quit IRC | 14:00 | |
Sam-I-Am | hm i dont know | 14:01 |
Sam-I-Am | just e-mailed her | 14:01 |
AJaeger | Is she disguised as notsogentle or guest today? ;) | 14:02 |
Sam-I-Am | AJaeger: thanks for the nodes on that past. | 14:02 |
Sam-I-Am | notes | 14:02 |
Sam-I-Am | patch. mobile typing is not working :) | 14:02 |
AJaeger | ;) | 14:02 |
*** annegentle has joined #openstack-doc | 14:02 | |
openstackgerrit | Merged openstack/openstack-manuals: Add Debian image default user https://review.openstack.org/159393 | 14:02 |
Sam-I-Am | figured we might see some issues with the teme | 14:02 |
Sam-I-Am | there's anne | 14:02 |
AJaeger | yeah... | 14:02 |
AJaeger | good morning, annegentle | 14:02 |
annegentle | hey all | 14:02 |
annegentle | sorry I'm late | 14:02 |
annegentle | we have a meetbot in here so let's do this | 14:02 |
annegentle | hm | 14:03 |
annegentle | that didn't work | 14:03 |
AJaeger | Really a meetbot? I doubt it. | 14:03 |
AJaeger | annegentle, just a way to publish to eavesdrop | 14:03 |
annegentle | #startmeeting docteam | 14:03 |
openstack | Meeting started Thu Feb 26 14:03:31 2015 UTC and is due to finish in 60 minutes. The chair is annegentle. Information about MeetBot at http://wiki.debian.org/MeetBot. | 14:03 |
openstack | Useful Commands: #action #agreed #help #info #idea #link #topic #startvote. | 14:03 |
annegentle | there we go | 14:03 |
openstack | The meeting name has been set to 'docteam' | 14:03 |
annegentle | #topic Action items from last meeting | 14:03 |
Sam-I-Am | oh, its in here. | 14:03 |
Sam-I-Am | fancy | 14:04 |
AJaeger | cool | 14:04 |
*** nickchase has joined #openstack-doc | 14:04 | |
annegentle | welcome nickchase | 14:04 |
annegentle | the last meeting had | 14:04 |
annegentle | asettle to investigate arch guide as a project for a docs swarm | 14:04 |
nickchase | Morning, all. | 14:04 |
annegentle | she emailed me and I think it's a great idea, so sure! | 14:04 |
annegentle | She's also looking for a location for them to meet up informally on the other side of the world | 14:05 |
annegentle | and then someone from RedHat is booking a spot for their swarm Aug 13-14 | 14:05 |
annegentle | from 2 weeks ago we had no action items | 14:05 |
annegentle | so, let's talk about review guidelines | 14:06 |
annegentle | #topic Review guidelines | 14:06 |
annegentle | anyone want to start or do you want me to do a recap? | 14:06 |
nickchase | I think a recap is probably in order. | 14:06 |
annegentle | Okay, how far back? We've had difficulties with people being frustrated with doc reviews for a while, going to Tom's ranty rant after the summit :) | 14:07 |
annegentle | Then last week nickchase also expressed frustration on the mailing list -- with nit picks mostly | 14:07 |
Sam-I-Am | the review guide on the wiki goes back pre-paris | 14:07 |
openstackgerrit | Merged openstack/openstack-manuals: Fix accidental change in neutron id https://review.openstack.org/159302 | 14:08 |
annegentle | ah yes Sam-I-Am | 14:08 |
annegentle | we had a discussion in Atlanta that resulted in the Wiki page at: | 14:08 |
annegentle | #link https://wiki.openstack.org/wiki/Documentation/ReviewGuidelines | 14:08 |
Sam-I-Am | it was intended to make the juno install guide go in nice and easy during the rush period | 14:09 |
annegentle | any other context or history | 14:09 |
AJaeger | not as an excuse, just to set perspective: Compared to some integrated projects, it's very easy to get patches into the manuals | 14:09 |
AJaeger | Both from the setup perspective as well as how we review stuff | 14:10 |
annegentle | yes I agree completely, and was wanting to bring that up as well | 14:10 |
AJaeger | That's why we get many new folks - and some that only do a single patch | 14:10 |
Sam-I-Am | yeah we're easy :) | 14:10 |
AJaeger | So, we help onboarding other contributors into OpenStack. | 14:10 |
annegentle | our timing is good, is our accuracy good? | 14:10 |
nickchase | That's one way of looking at it. :) | 14:10 |
AJaeger | If they get scared by us, they wouldn't survive the integrated projects ;) | 14:10 |
annegentle | heh we're the nice ones | 14:11 |
AJaeger | Still I would love to have them onboarded | 14:11 |
nickchase | Yes, you know, that's a great way to think about it. | 14:11 |
Sam-I-Am | a lot of people get their ATCs with docs | 14:11 |
annegentle | yeah there are definitely people with info in their heads that we need out of their heads | 14:11 |
annegentle | Sam-I-Am: really? I don't think it's statistically significant? | 14:11 |
AJaeger | I'm not saying we can rest, I think we're all convinced that we can improve | 14:11 |
nickchase | agreed. | 14:11 |
annegentle | yes | 14:11 |
Sam-I-Am | annegentle: i know of a few | 14:12 |
annegentle | so what are some of the solutions? | 14:12 |
*** chandankumar has joined #openstack-doc | 14:12 | |
AJaeger | we also have to balance whatever we do with the work it puts on us. | 14:12 |
nickchase | Maybe we should have a boilerplate email for first time contributors. When we do a review... | 14:12 |
annegentle | Sam-I-Am: it's less than 1% I'm sure of all ATC badges | 14:12 |
Sam-I-Am | we're probably the least-encumbered project. you can patch an isolated thing in docs and not go through a whole gating process. | 14:12 |
AJaeger | nickchase, we have already | 14:12 |
annegentle | nickchase: we do | 14:12 |
nickchase | of their first patch, we should maybe send them an email that explains.... | 14:12 |
nickchase | what we're doing and why so they don't get freaked out. | 14:12 |
nickchase | I'm not familiar with this initial email. | 14:13 |
Sam-I-Am | there is one, but maybe it could use some updates | 14:13 |
nickchase | Everyone knowing it exists would be good. :) | 14:13 |
Sam-I-Am | AJaeger: do you know what manages it? | 14:13 |
annegentle | nickchase: I'll find one, we've had a lot of new contributors to api docs lately | 14:13 |
AJaeger | Sam-I-Am, some infra magic | 14:14 |
annegentle | #link https://review.openstack.org/#/c/154484/ | 14:14 |
annegentle | nickchase: look at the "Welcome, new contributor!" line for the text | 14:15 |
annegentle | "don't be concerned if requested to make corrections" | 14:15 |
annegentle | "be paitent and be available" | 14:15 |
nickchase | yes, I was just looking. | 14:15 |
*** salv-orlando has quit IRC | 14:15 | |
nickchase | I'm thinking there are definitely some things that could be added. | 14:15 |
AJaeger | The text was written by Tom fifieldt | 14:15 |
fifieldt | hola | 14:15 |
AJaeger | It'S the same text for all projects | 14:15 |
nickchase | Hey, fifeldt | 14:16 |
annegentle | nickchase: yes, just grep for key phrases in the infra repos | 14:16 |
nickchase | aha. | 14:16 |
annegentle | hey fifieldt | 14:16 |
AJaeger | yeah, me summoned fifieldt ;) | 14:16 |
* fifieldt tries to catch up with scrollback | 14:16 | |
nickchase | ok, so that answers my next question: is this for initial DOCS contributions or for their first contribution period. | 14:16 |
AJaeger | nickchase, first contribution to openstack overall | 14:16 |
annegentle | everyone, all projects | 14:16 |
nickchase | OK, so what I was hoping for was something doc-specific. | 14:17 |
annegentle | nickchase: I'll fight you to keep it "just like code" | 14:17 |
annegentle | :) | 14:17 |
annegentle | nickchase: we really don't want to set up "other" or docs ghetto | 14:17 |
Sam-I-Am | annegentle: just a heads up, the bus internet is flaky :/ | 14:17 |
annegentle | nickchase: I feel so strongly about it that I can hardly type enough :) | 14:17 |
nickchase | Well, then I'll go back to my first thought: maybe we need an email that "mentors" can send to first time contributors. | 14:18 |
nickchase | Which is what I was thinking in the first place. | 14:18 |
annegentle | nickchase: I really like the mentoring idea | 14:18 |
annegentle | nickchase: it's more personal than a bot | 14:18 |
fifieldt | btw, if you want a custom "Welcome, new Contributor" just for docs, we can probably do that | 14:18 |
nickchase | exactly | 14:18 |
annegentle | fifieldt: I'd block it, honestly. I feel very strongly that as we go to team's self service we need to not set apart docs from any other type of contribution. | 14:19 |
fifieldt | works for me | 14:19 |
Sam-I-Am | do we want to reach out to people, or tell them to reach out to us if they want to contribute more? | 14:19 |
AJaeger | I'm with annegentle | 14:19 |
annegentle | teams are going to get less and less support from us in the way of reviews anyway | 14:19 |
openstackgerrit | Sayali Lunkad proposed openstack/training-guides: Modifies osbash files to use osbash ssh keys https://review.openstack.org/158668 | 14:19 |
annegentle | but we do have to train reviewers of docs specifically | 14:19 |
*** sarob has joined #openstack-doc | 14:20 | |
annegentle | so I do think we should noodle on what a doc mentoring pairing would be like | 14:20 |
annegentle | I think the specialty teams are one way this is happening already, people are meeting each other due to common knowledge areas | 14:20 |
Sam-I-Am | onboarding for both contributions and reviews makes sense | 14:20 |
AJaeger | there'Re some people that need mentoring - and some just grab it easily ;) | 14:20 |
annegentle | some of the discussion does have to lead to our own agreement on what we review -- content, conventions, technical accuracy | 14:21 |
AJaeger | but even the later ones have questions... | 14:21 |
annegentle | agreed AJaeger | 14:21 |
nickchase | agreed | 14:21 |
annegentle | I also strongly feel that anything that leads to another doc bug being filed is broken. | 14:21 |
annegentle | we have way too many doc bugs and no clear assignees | 14:22 |
nickchase | disagreed :) | 14:22 |
annegentle | nickchase: I know :) | 14:22 |
annegentle | and prioritizing cleanup over content is also problematic for our end goal of providing accurate docs | 14:22 |
nickchase | I'll go back to my original assertion: if people with the skills for the hard stuff could leave the "monkey work" to someone else there would be fewer of the hard bugs you're worried about. | 14:22 |
nickchase | agreed. | 14:23 |
annegentle | what I see in the API docs is that the patch needs to be very clean because NO ONE will clean it up, two case in points that came up this week are the Firewall aaS and VPN aaS docs. | 14:23 |
annegentle | last updated in 2013, warned since last August they were going away, just yesterday noticed that they were gone. | 14:23 |
fifieldt | I think WADL is quite a different beast to other docs | 14:23 |
annegentle | fifieldt: true that :) | 14:23 |
Sam-I-Am | agreed on that | 14:23 |
*** wastrel has joined #openstack-doc | 14:24 | |
*** wastrel has joined #openstack-doc | 14:24 | |
nickchase | We NEVER have a surfeit of low-hanging-fruit. | 14:24 |
annegentle | so nickchase I am interested in identifying ways to clean up | 14:24 |
fifieldt | I believe most of what we're talking about here is not api site stuff | 14:24 |
AJaeger | fifieldt, it's the extreme end but shows the problem | 14:24 |
Sam-I-Am | i suspect un-encumbered rst with an easier too chain will reduce some of the overhead for any kind of patch, even fix-ups | 14:24 |
annegentle | and, with the mentoring idea, we WILL need more low hanging fruit | 14:24 |
nickchase | yes. | 14:24 |
openstackgerrit | Merged openstack/api-site: Fix a explain of "Create subnet" Remove following sentence. https://review.openstack.org/158160 | 14:24 |
AJaeger | yeah, setting up maven and getting docbook right is not that trivial | 14:24 |
Sam-I-Am | question is... does non-impactful edits need bugs? | 14:25 |
*** sarob has quit IRC | 14:25 | |
AJaeger | Sam-I-Am, clear no from my perspective | 14:25 |
taroth | from my perspective: no | 14:25 |
fifieldt | at the moment we track quite a lot of these sorts of things with generic bugs | 14:25 |
fifieldt | like one per book | 14:25 |
Sam-I-Am | yeah, or a bp/spec | 14:25 |
AJaeger | Sam-I-Am, I mean: IF you notice something, no need to open a bug. | 14:25 |
fifieldt | eg https://bugs.launchpad.net/openstack-manuals/+bug/1217503 | 14:26 |
openstack | Launchpad bug 1217503 in openstack-manuals "Apply document markup conventions to source XML files" [Wishlist,In progress] | 14:26 |
annegentle | is there a way to have low hanging fruit without bugs? | 14:26 |
AJaeger | Another problem is if you know something is wrong and cannot fix it directly - how to record that? | 14:26 |
annegentle | the bug thing makes me worried | 14:26 |
nickchase | OK, hang on, I have a very basic question: | 14:26 |
*** KLevenstein has joined #openstack-doc | 14:26 | |
AJaeger | annegentle, we can always track it elsewhere - or as part of a single bug. | 14:26 |
Sam-I-Am | annegentle: maybe an ongoing low-hanging-fruit bug that keeps a list of particular places that need attention? | 14:27 |
nickchase | Call me crazy -- and I'm not suggesting that tracking as a single bug is a Bad Thing -- but why (aside from statistics) are more bugs so terrible? | 14:27 |
Sam-I-Am | "first time contributor bug" heh | 14:27 |
annegentle | nickchase: for a few reasons | 14:27 |
annegentle | 1) projects will need to track their own doc bugs in the big tent | 14:27 |
fifieldt | will they? | 14:28 |
fifieldt | :) | 14:28 |
annegentle | 2) bugs for "shared" project docs are already too high with over 500 | 14:28 |
annegentle | 3) more bugs means less trust of docs | 14:28 |
annegentle | fifieldt: it remains to be seen :) | 14:28 |
fifieldt | 3 is clearly moot - there are already more bugs in docs than neutron :) | 14:28 |
Sam-I-Am | most of our bugs are these docimpacts people throw over the fence | 14:29 |
fifieldt | so since #1 is still debatable, that leaves #2 | 14:29 |
annegentle | ha | 14:29 |
Sam-I-Am | what we need is more of those people contributing | 14:29 |
fifieldt | and #2 can be combated by making a separate launchpad project or (laugh here) a special category on storyboard | 14:29 |
nickchase | Sam-I-Am: agreed | 14:29 |
annegentle | Sam-I-Am: right and the current mailing list discussion of rolling releases doesn't give me hope many will contribute :) | 14:29 |
Sam-I-Am | we're not here to understand the intricacies of all projects. we're here to make the docs usable. | 14:29 |
annegentle | Sam-I-Am: we can also debate "which docs" usable | 14:29 |
annegentle | Sam-I-Am: if we narrow the scope to only what we have now, what might change about our reviews? | 14:30 |
* nickchase is feeling bad because after that whole "template" discussion we had in Atlanta he never got it done. | 14:30 | |
annegentle | nickchase: no worries, someone else did it right? | 14:30 |
Sam-I-Am | nickchase: we all have our dumpster fires | 14:30 |
annegentle | so another idea | 14:30 |
annegentle | for each deliverable, have smaller review teams | 14:30 |
nickchase | annegentle: not that I know of | 14:30 |
annegentle | get rid of the central docs-core and have cores on individual books. Go. | 14:31 |
nickchase | how does that help, though? | 14:31 |
annegentle | better yet. -- only track bugs against one deliverable | 14:31 |
fifieldt | does anyone feel like we're starting to mix issues here? "The Way Forward" Big thinking, with a current issue on review narkyness :) | 14:31 |
AJaeger | annegentle, independed of this: let's cleanup docs-core of people that didn't review anything in the last 6 months. We have a few of these AFAIR | 14:31 |
annegentle | then we'll know which ones are the most "in trouble" | 14:31 |
Sam-I-Am | fifieldt: timecube :) | 14:32 |
annegentle | AJaeger: sure, and there are lots of people wanting to be core, but it might be easier for them to become core on a single book at a time | 14:32 |
nickchase | fifieldt: I don't think so | 14:32 |
KLevenstein | annegentle: books core = more formal version of the "specialty team"? | 14:32 |
*** sld has joined #openstack-doc | 14:32 | |
fifieldt | it's not a terrible idea | 14:32 |
annegentle | KLevenstein: right. The Security Guide team does this already, where only security team members can actually publish that book. | 14:32 |
AJaeger | annegentle, we can only have cores per repository. | 14:32 |
annegentle | it's a handshake right now, as in, AJaeger and I "know" not to publish their book. | 14:33 |
annegentle | There's also a balancing act between "protection of publish rights" and "speed of change" | 14:33 |
AJaeger | I'm not yet completely convinced that all the special teams do work great... | 14:33 |
AJaeger | Each needs a driving force behind it | 14:33 |
nickchase | ok, so that I feel is off track. | 14:33 |
nickchase | :) | 14:33 |
annegentle | I think that it's part of what nickchase was struggling with though. | 14:33 |
annegentle | nickchase: you can't override a core's decision | 14:34 |
annegentle | or is it the "anyone's -1 blocking"? | 14:34 |
Sam-I-Am | i think each subteam will have their qualms for their specific document | 14:34 |
Sam-I-Am | theres general review guidelines, sure | 14:34 |
nickchase | It's the "anyone's -1 blocking". | 14:34 |
annegentle | many of the suggestions revolve around "don't block, fix" | 14:34 |
annegentle | and the only difficuly I had with one of the "fix" suggestions was log a bug. | 14:35 |
nickchase | that's true. | 14:35 |
annegentle | I guess I can relax a bit and know we'll always have more bugs than the team. | 14:35 |
AJaeger | annegentle, I find it important that we have a shared team - overlapping - so that knowledge gets exchanged. Not every special team should reinvent their own conventions. | 14:35 |
Sam-I-Am | sometimes its easier just to slurp someone's patch and fix it rather than go through a bunch of -1s, especially for new contributors. | 14:35 |
annegentle | AJaeger: very true, that. | 14:35 |
fifieldt | AJaeger, agreed | 14:35 |
fifieldt | and we'll also still have our beloved common directory ;) | 14:35 |
nickchase | AJaeger: agreed | 14:35 |
annegentle | (know we, docs, will have more bugs than individual project teams) | 14:35 |
Sam-I-Am | question is... are the issues bad enough to keep it from being published. | 14:36 |
*** chandankumar has quit IRC | 14:36 | |
AJaeger | and anybody can take the patch and fix it. So, if I do a -1 and don't have time to fix it, nickchase can fix the patch up properly. | 14:36 |
nickchase | If it's marked so I can FIND it, sure. | 14:36 |
Sam-I-Am | might be possible to partial-bug something that needs fixups rather than generating a new bug | 14:36 |
Sam-I-Am | then closes-bug once its fixed | 14:36 |
fifieldt | one issue with fixing a patch for a newcomer is ensuring education about what they should do if they subsequently need to update it | 14:36 |
fifieldt | otherwise it can be confusing as hell | 14:36 |
AJaeger | Are we in a hurry to publish patches? | 14:36 |
fifieldt | so probably worth getting some generic text in order for that | 14:36 |
fifieldt | to explain what we've done and why | 14:36 |
fifieldt | and how to update their own repo | 14:36 |
nickchase | OK, so I think fifieldt hits on where we started: communication. | 14:36 |
AJaeger | fifieldt, exactly: So, what I do sometimes: Do a proper review and then mark it as WIP with a note "Let me fix this for you...." | 14:37 |
*** steveg is now known as sgordon | 14:37 | |
sld | fifieldt: are you talking about cherrypicking, or simply pulling in updates to re-edit files? | 14:37 |
nickchase | Right. If you tell someone to update their patch, in general, unless they're really experienced, you will get a blank stare. | 14:37 |
fifieldt | sld: review -d 89789078907; git commit -a; git review | 14:37 |
sld | ah | 14:37 |
AJaeger | I think fifieldt is saying that we should tell them how to fix their patch, we should help them doing the second iteration of it | 14:37 |
nickchase | +1 | 14:38 |
fifieldt | no | 14:38 |
fifieldt | what I'm saying is if we are fixing their patch | 14:38 |
fifieldt | we need to explain the process we're taking | 14:38 |
AJaeger | Ah... | 14:38 |
nickchase | +1 on that too. :) | 14:38 |
sld | lol | 14:38 |
Sam-I-Am | explaining is +++ | 14:38 |
nickchase | I think either way it's better than what we have now. | 14:38 |
annegentle | #link https://wiki.openstack.org/wiki/Documentation/HowTo#How_to_amend_a_review-in-progress | 14:38 |
fifieldt | just looking for some text that says "hey, there's this stupid thing. I'm going to fix it for you quickly so you don't have to waste your time. This is going to break your local repo, so do this: btw this is what I did" | 14:39 |
annegentle | I've started pasting that into the review when it needs patching | 14:39 |
sld | fifieldt: awesome idea | 14:39 |
annegentle | I'll add to it what to do when someone else patches your patch | 14:39 |
AJaeger | nickchase, I think you're only seeing a few bad examples, there's a lot of good work already happening | 14:39 |
AJaeger | and especially fifieldt'S communication is great | 14:39 |
fifieldt | https://etherpad.openstack.org/p/docs-fixed-it-for-you <-- anyone care to edit | 14:39 |
nickchase | AJaeger: I'm glad, but if people don't know that we have a problem. | 14:40 |
nickchase | So ok, let me recap for a moment, if that's OK... | 14:40 |
nickchase | We agree that we need to do something, and communication seems to be the best answer. We are crafting a "standard" message that we can give to newbies when we fix their stuff https://etherpad.openstack.org/p/docs-fixed-it-for-you with the idea that ... | 14:41 |
annegentle | the idea that we communicate "this is how we work, welcome!" | 14:41 |
nickchase | it will get things in quickly, not frustrate people, and not tick them off or make them feel stepped on, while still educating them on what it is that they can do better next time. | 14:41 |
annegentle | yes, education is key | 14:42 |
AJaeger | so, when do we fix and when do we just comment? | 14:42 |
Sam-I-Am | one of the things we discussed was how docs makes things look pretty after the actual meat is done. so editing other people's patches should be weird. | 14:42 |
nickchase | I think that's a judgement call on the revieiwer. | 14:42 |
AJaeger | I think a rule of thumb would be if it'S less than 3 edits, fix yourself, if it's more than 10 - let the author do it... | 14:42 |
Sam-I-Am | someone does the hard work of configuring X thing, and we make it pretty. | 14:42 |
nickchase | And there's definite value in that. | 14:43 |
annegentle | Sam-I-Am: WE DO NOT MAKE IT PRETTY NEVER SAY THAT IN MY PRESENSE AGAIN | 14:43 |
annegentle | dead serious | 14:43 |
nickchase | Are you objecting to ... | 14:43 |
AJaeger | Sam-I-Am, yes, we can do this as well - but that's something we should *arrange* and communicate before | 14:43 |
nickchase | the notion that we clean things up, or the word "pretty"? | 14:43 |
annegentle | we make things consistent and more readable, therefore more usable | 14:43 |
nickchase | (also dead serious) | 14:43 |
nickchase | Ah, so "pretty". | 14:43 |
Sam-I-Am | notion that we know our nitpicky conventions that keep everything presentable and sane | 14:44 |
annegentle | it might be a "girl" thing but that is the fast track to the docs ghetto. | 14:44 |
annegentle | we know how to make the contribution fit with the rest of the docs, which naturally we are more accustomed to and familiar with | 14:44 |
* Sam-I-Am transfer to phoneirc | 14:44 | |
KLevenstein | annegentle: fwiw agreed, "pretty" does can an implication of "looks nice, not much there" | 14:44 |
annegentle | right. | 14:45 |
KLevenstein | *can have an; valkyrie needs coffee | 14:45 |
nickchase | annegentle: maybe I'm the weird one, I just think "pretty" in the context of "pretty-print". But that's probably just me. Connotations acknowledged. | 14:45 |
*** etoews has joined #openstack-doc | 14:45 | |
annegentle | heh | 14:45 |
nickchase | OK, so let me go back for a moment... | 14:45 |
fifieldt | text @ https://etherpad.openstack.org/p/docs-fixed-it-for-you is a little less informal now for y'all if desired | 14:45 |
nickchase | to "we make things consistent and more readable, therefore more usable" ... | 14:46 |
nickchase | Are you referring to conventions here? | 14:46 |
annegentle | nickchase: yes | 14:46 |
annegentle | nickchase: also better writing, less meandering is easier to read | 14:46 |
nickchase | So you're saying there that WE handle the conventions. | 14:47 |
nickchase | Which is different from making the author handle the conventions. | 14:47 |
nickchase | Also that we fix the "writing" | 14:47 |
nickchase | which is useful when we are trying to get information out of engineer brains. | 14:47 |
nickchase | Which brings me back to... | 14:47 |
*** sarob has joined #openstack-doc | 14:47 | |
Sam-I-Am | in other words, if someone docs a new swift feature, no one here really know the internals of swift, but we can make it conform and presentable like the other docs | 14:47 |
annegentle | nickchase: sometimes. it's a judgement call, which is why I'd like us to train more people on good judgement. | 14:47 |
nickchase | my original assertion: that we should let them focus on the stuff that's only in their brains. | 14:48 |
Sam-I-Am | with rst i think well get a lot more "engineer" contribs | 14:48 |
nickchase | I agree, which is why it's REALLY important that... | 14:48 |
annegentle | Sam-I-Am: that's the hope, and swift already does all their docs in rst really | 14:48 |
nickchase | we use this opportunity to encourage those people and not drive them away. | 14:48 |
AJaeger | nickchase, we can do this in special cases - but not for each and every patch | 14:48 |
annegentle | but with RST we will still have markup conventions | 14:48 |
Sam-I-Am | swift was a bad example | 14:49 |
Sam-I-Am | i hope our rst isnt as cumbersome | 14:49 |
fifieldt | bottom line: we want every review on every patch to be encouraging that patch submitted to become the #1 docs contributor | 14:49 |
Sam-I-Am | rst is designed to be light | 14:49 |
fifieldt | s/submitted/submitter/ | 14:49 |
sld | fifieldt: i like that ideology / concept. :) | 14:50 |
nickchase | fifieldt: it sounds sappy, but, well, yeah. | 14:50 |
sld | the more someone is encouraged, the more they contribute. | 14:50 |
*** chandankumar has joined #openstack-doc | 14:50 | |
Sam-I-Am | the more they dont have to waste time on nits | 14:50 |
nickchase | I have a suggestion: | 14:50 |
berendt | what about an easy and light step-by-step guide "how to commit to openstack documentation in 10 minutes"? At the moment we link to https://wiki.openstack.org/wiki/Documentation/HowTo on http://docs.openstack.org/. This is a complex and long document and as a first time contributor I do not know if i have to read the whole document, what are the relevant parts, and so on. | 14:50 |
annegentle | berendt: it is long, isn't it? | 14:50 |
fifieldt | https://wiki.openstack.org/wiki/Documentation/HowTo/FirstTimers | 14:51 |
fifieldt | something like that? | 14:51 |
sld | yeah | 14:51 |
nickchase | Unfortunately, there are a LOT of steps that are actually necessary. | 14:51 |
nickchase | but | 14:51 |
Sam-I-Am | berendt: our conventions are a mile long too | 14:51 |
AJaeger | There's also http://docs.openstack.org/infra/manual/ | 14:51 |
fifieldt | random idea: | 14:51 |
fifieldt | hmm | 14:51 |
fifieldt | maybe not | 14:51 |
AJaeger | not doc specific - but the new generic information for OpenStack contribution | 14:51 |
*** KLevenstein_ has joined #openstack-doc | 14:51 | |
nickchase | OK, I have a potential compromise: | 14:52 |
*** sarob has quit IRC | 14:52 | |
nickchase | We want people to not be frustrated or bogged down, but we don't want a preponderance of new bugs. One way to do that would be ... | 14:52 |
berendt | I think there should be a light document for a first time contributor making it really easy to push a first commit. I do not think that any new contributor reads the linked document before the first commit. | 14:53 |
*** KLevenstein has quit IRC | 14:53 | |
*** KLevenstein_ is now known as KLevenstein | 14:53 | |
nickchase | If we institute a policy that if you see something simple, it's OK to just fix it with the text in https://etherpad.openstack.org/p/docs-fixed-it-for-you . If it's more complicated.... | 14:53 |
AJaeger | During reviews, I often link to special sections of the conventions | 14:53 |
sld | AJaeger: +1 - it's been immensely helpful, too. :) | 14:54 |
annegentle | AJaeger: me too | 14:54 |
annegentle | nickchase: yep, I think that's the way. | 14:54 |
nickchase | then we tell the author that this is what it needs, but if they are willing to file a new bug and paste the URL in the comments, then we can close this one. (I'm assuming these are non-impactful) bugs. The hassle of filing a new bug... | 14:54 |
AJaeger | and I even got this week a comment: I would have loved to know about the markup conventions before I did my first patch.. | 14:54 |
annegentle | AJaeger: yeah! from Robin I think? | 14:55 |
nickchase | will discourage most people and encourage them to do the right thing and just do the fix, but in extreme cases we will have a smaller number of new bugs that a first-timer can patch. | 14:55 |
annegentle | great summary | 14:55 |
nickchase | Would that be OK? | 14:55 |
KLevenstein | so, in fact—I wrote a lightweight “how to contribute to openstack” doc for my team at rackspace to try and simplify what’s at the main page. would be happy to share it. | 14:55 |
AJaeger | annegentle, don't remember who it was | 14:55 |
berendt | KLevenstein: cool | 14:55 |
taroth | KLevenstein: great | 14:55 |
annegentle | KLevenstein: cool | 14:55 |
annegentle | sorry we'd better get to the other topics! | 14:55 |
nickchase | KLevenstein: definitely | 14:56 |
KLevenstein | I don’t know how much simpler it actually is, but. | 14:56 |
nickchase | OK, so do we agree on this, then? | 14:56 |
AJaeger | KLevenstein, let's share and look | 14:56 |
annegentle | Yes. | 14:56 |
openstackgerrit | Merged openstack/openstack-manuals: Update CLI reference for python-openstackclient 1.0.2 https://review.openstack.org/159452 | 14:56 |
nickchase | EXCELLENT. | 14:56 |
annegentle | #agreed institute a policy that if you see something simple, it's OK to just fix it with the text in https://etherpad.openstack.org/p/docs-fixed-it-for-you | 14:56 |
Sam-I-Am | rst toolchain should make it lighter | 14:56 |
annegentle | KLevenstein: do you want an action item to share that? | 14:57 |
KLevenstein | annegentle: sure | 14:57 |
annegentle | #action KLevenstein to share a lightweight “how to contribute to openstack” doc | 14:57 |
annegentle | Okay | 14:57 |
annegentle | not sure I need another agreed statement on the more complex policies? | 14:58 |
annegentle | Something like | 14:58 |
openstackgerrit | Merged openstack/openstack-manuals: Update CLI reference for python-cinderclient 1.1.1 https://review.openstack.org/159435 | 14:58 |
annegentle | #agreed for balancing a contributor's frustration level with publishing ease, please use good judgement and seek out guidance | 14:58 |
annegentle | Okay better get to User Guides new specialty team | 14:58 |
nickchase | annegentle: sorry to be nitpicky, but I don't see the part about enabling a person to get a bug closed by filing a new one if they're motivated to do that. | 14:59 |
annegentle | #topic User Guides new specialty team | 14:59 |
nickchase | If that's implicit, fine. | 14:59 |
annegentle | nickchase: that was complex to me :) | 14:59 |
annegentle | nickchase: and a judgement call | 14:59 |
nickchase | ok, let's move on. I'll post a proposed statement to the list. | 14:59 |
annegentle | ok thanks | 15:00 |
annegentle | taroth: thanks for joining us, sorry we didn't get to the User Guide for long | 15:00 |
taroth | annegentle: np | 15:00 |
annegentle | taroth: and I do owe you an email back on your excellent questions about the user guide and admin guide | 15:00 |
annegentle | also | 15:00 |
annegentle | #topic Installation Guides split for Kilo | 15:00 |
annegentle | we no longer publish install guides to /trunk/ | 15:00 |
*** chandankumar has quit IRC | 15:01 | |
annegentle | and it is open to kilo now, right Sam-I-Am? | 15:01 |
*** chandankumar has joined #openstack-doc | 15:01 | |
annegentle | heh no one else has to use this meeting room bwah hah ha | 15:01 |
AJaeger | annegentle, did you remove /trunk/install-guides and /trunk/training-guides as well? | 15:01 |
nickchase | :) | 15:01 |
AJaeger | we should announce that it's open | 15:01 |
sld | AJaeger: remove = .htaccess or actual filesystem file removal .. or both? | 15:02 |
*** chandankumar has quit IRC | 15:02 | |
sld | err .htaccess redirects | 15:02 |
annegentle | AJaeger: oh I can do that today since I'm home | 15:02 |
AJaeger | sld, rm -rf docs.openstack.org/trunk/{install-guide,training-guides} - and add proper redirects | 15:02 |
sld | ah | 15:02 |
fifieldt | the magical password that only exists on Anne's PC at home :D | 15:02 |
annegentle | fifieldt: actually it's about the network | 15:02 |
AJaeger | fifieldt, the one she wanted to share? ;) | 15:02 |
fifieldt | oh, right, I see :) | 15:02 |
fifieldt | I'm just having vague recollections | 15:03 |
annegentle | fifieldt: I sorted the other by phoning infra :) | 15:03 |
fifieldt | of amusement | 15:03 |
fifieldt | Who you gonna call :) | 15:03 |
annegentle | ghostbusters! | 15:03 |
sld | annegentle: that's my line! lol | 15:03 |
AJaeger | sld, that was the password ;) | 15:03 |
taroth | :) | 15:03 |
annegentle | Okay, I did want to bring up https://review.openstack.org/#/c/157303/ since there's a concern this merged too fast | 15:03 |
annegentle | it wasn't tested, and doesn't tell the user to change the API version | 15:04 |
annegentle | it's fairly safe since it's not published, though, but, this is where "it's a judgement call" comes in -- did anyone log a bug about it? | 15:04 |
annegentle | Sam-I-Am: you noticed it, can you log a bug for investigation? | 15:04 |
fifieldt | is trunk still broken for cinderclient, Sam-I-Am? | 15:05 |
annegentle | he's on his phone so might have difficulty, I'll follow up and let us end the meeting! | 15:05 |
nickchase | thanks everyone! | 15:05 |
AJaeger | can we talk about the driver docs spec? | 15:05 |
AJaeger | https://review.openstack.org/#/c/133372/ | 15:05 |
annegentle | The doc tools update is on the mailing list too, so that's all for now | 15:05 |
annegentle | AJaeger: oh yes. What are your thoughts now? | 15:05 |
* AJaeger likes to hand over the spec to somebody else... | 15:06 | |
openstackgerrit | Merged openstack/openstack-manuals: Update CLI reference for python-ceilometerclient 1.0.13 https://review.openstack.org/159434 | 15:06 |
AJaeger | fifieldt raised a point during review that we might have good documentation that won't be that easy to move to vendor docs. | 15:06 |
annegentle | I am frankly surprised at how little vendor doc there is on _their_ sites | 15:06 |
annegentle | it's like we made TOO good a docs site. ha. | 15:07 |
AJaeger | I was thinking whether we should make "maintenance" of the doc a requirement | 15:07 |
berendt | AJaeger: +1 | 15:07 |
annegentle | So I'm feeling a little like our proposed solution wouldn't work anyway, to link to vendor sites. | 15:07 |
AJaeger | So, either they do a minimal spec that needs no maintenance | 15:07 |
annegentle | #topic Driver docs spec | 15:07 |
AJaeger | Or if they want something more flashed on our side, we need one contact person and an update for each release... | 15:07 |
AJaeger | and if nothing happens and the content is outdated, we revert it to the minimal doc | 15:08 |
annegentle | I feel like we already have a carrot, a great docs site that many people just use as "the place" to find out how to use a driver. | 15:08 |
berendt | we should also note that we will remove content if the contact person is not responsive and if there is no update after a release | 15:08 |
annegentle | so the stick is removing the content, right? | 15:08 |
AJaeger | annegentle, yep | 15:08 |
annegentle | AJaeger: ok so is the spec saying that currently? I don't recall | 15:09 |
AJaeger | No, it'S not - the spec currently says we will have minimal doc for everything. | 15:09 |
annegentle | AJaeger: I think the spec has been very valuable to find out the facts. | 15:09 |
fifieldt | +1 | 15:09 |
annegentle | AJaeger: and has done its job of finding a good solution. | 15:09 |
AJaeger | But seeing the recent feedback, I'm considering changing it. | 15:09 |
annegentle | AJaeger: thanks so much for doing the work of discovery | 15:09 |
annegentle | AJaeger: yes, I agree | 15:09 |
AJaeger | And the stick is one approach ;) | 15:09 |
annegentle | I think we found out important aspects that gave us both carrot and stick :) | 15:09 |
AJaeger | If anybody has a better one, please tell. | 15:09 |
fifieldt | sounds like AJaeger has things under control as usual :) | 15:10 |
annegentle | what sucks, honeslty, is that even teh stick creates work | 15:10 |
annegentle | it's maddening | 15:10 |
AJaeger | fifieldt, this has been going on for far too long for me ;( | 15:10 |
fifieldt | absolutely | 15:10 |
annegentle | AJaeger: yeah let's get resolution | 15:10 |
AJaeger | What about the following plan: | 15:10 |
fifieldt | sorry for the lengthy reply times, but I think this is quite important to do right | 15:10 |
AJaeger | action for me to update the spec | 15:11 |
*** mattfarina has joined #openstack-doc | 15:11 | |
AJaeger | We review quickly and annegentle makes a last call in her weekly doc status mail | 15:11 |
annegentle | sounds good | 15:11 |
AJaeger | and next wednesday it gets approved | 15:11 |
*** jecarey has joined #openstack-doc | 15:11 | |
fifieldt | works for me | 15:11 |
annegentle | #action AJaeger to update the docs driver spec at https://review.openstack.org/#/c/133372/ | 15:12 |
* Sam-I-Am has internet again | 15:12 | |
annegentle | #action annegentle to make a call for final review in the weekly docs status update post | 15:12 |
AJaeger | WElcome back, Sam-I-Am ! | 15:12 |
annegentle | Sam-I-Am: great! Was just asking if you had logged a doc bug for the cinder client testing for the install guide to close that loop. | 15:12 |
annegentle | #action annegentle to update .htaccess and then delete /trunk/install and /trunk/training-guides | 15:13 |
annegentle | I think that's it | 15:13 |
annegentle | thanks all for joining and going over, sorry about that. | 15:13 |
Sam-I-Am | annegentle: no, i havent.. | 15:13 |
AJaeger | annegentle, also check the index pages for any mention fo these | 15:13 |
Sam-I-Am | annegentle: i think we'll be trying the openstack client for kilo... it might work better :) | 15:13 |
annegentle | AJaeger: got it | 15:13 |
*** salv-orlando has joined #openstack-doc | 15:14 | |
AJaeger | thanks, annegentle ! | 15:14 |
annegentle | #endmeeting | 15:14 |
openstack | Meeting ended Thu Feb 26 15:14:18 2015 UTC. Information about MeetBot at http://wiki.debian.org/MeetBot . (v 0.1.4) | 15:14 |
openstack | Minutes: http://eavesdrop.openstack.org/meetings/docteam/2015/docteam.2015-02-26-14.03.html | 15:14 |
openstack | Minutes (text): http://eavesdrop.openstack.org/meetings/docteam/2015/docteam.2015-02-26-14.03.txt | 15:14 |
openstack | Log: http://eavesdrop.openstack.org/meetings/docteam/2015/docteam.2015-02-26-14.03.log.html | 15:14 |
annegentle | yay meetbot | 15:14 |
annegentle | now back to your regularly scheduled openstack-doc programming | 15:14 |
annegentle | I have an awful headache and will be away from glowing things today, sorry. | 15:14 |
AJaeger | ;) | 15:14 |
KLevenstein | feel better! | 15:15 |
AJaeger | And I was jsut hoping you would fix the theme to make Sam-I-Am happy ;) | 15:15 |
taroth | annegentle: get better soon :) | 15:15 |
AJaeger | Get well, annegentle ! | 15:15 |
Sam-I-Am | annegentle: feel better :) | 15:16 |
*** annegentle has quit IRC | 15:16 | |
*** sld has quit IRC | 15:21 | |
*** etoews has quit IRC | 15:22 | |
openstackgerrit | Christian Berendt proposed openstack/openstack-manuals: Update huawei driver configuration https://review.openstack.org/150761 | 15:26 |
openstackgerrit | Christian Berendt proposed openstack/openstack-manuals: Automatically generated cinder_backups_swift table https://review.openstack.org/159170 | 15:30 |
*** sarob has joined #openstack-doc | 15:32 | |
*** linuxhermit has left #openstack-doc | 15:32 | |
*** igordcard has joined #openstack-doc | 15:32 | |
*** etoews has joined #openstack-doc | 15:34 | |
*** fminzoni has quit IRC | 15:39 | |
*** sarob has quit IRC | 15:44 | |
*** AJaeger has quit IRC | 15:48 | |
*** reed has joined #openstack-doc | 15:48 | |
*** igordcard has quit IRC | 15:50 | |
*** igordcard has joined #openstack-doc | 15:58 | |
*** ildikov_afk is now known as ildikov | 16:01 | |
*** xgerman has joined #openstack-doc | 16:02 | |
*** mikedillion has joined #openstack-doc | 16:03 | |
*** pm90_ has joined #openstack-doc | 16:04 | |
*** pm90_ has quit IRC | 16:06 | |
*** pm90_ has joined #openstack-doc | 16:07 | |
*** Marga_ has joined #openstack-doc | 16:08 | |
*** mikedillion has quit IRC | 16:11 | |
*** erikwilson has joined #openstack-doc | 16:14 | |
*** erikmwilson is now known as Guest17798 | 16:14 | |
*** erikwilson is now known as erikmwilson | 16:14 | |
*** erikwilson has joined #openstack-doc | 16:14 | |
*** annegentle has joined #openstack-doc | 16:16 | |
*** annegentle has quit IRC | 16:22 | |
*** sayan has joined #openstack-doc | 16:27 | |
*** nickchase has quit IRC | 16:33 | |
*** david-lyle_afk is now known as david-lyle | 16:36 | |
*** Marga_ has quit IRC | 16:42 | |
*** amotoki has quit IRC | 16:43 | |
*** stevemar has joined #openstack-doc | 16:44 | |
*** koolhead17 has quit IRC | 16:48 | |
*** pcaruana has quit IRC | 16:50 | |
openstackgerrit | Olena Logvinova proposed openstack/openstack-manuals: Adds swift_store_cacert option to config reference https://review.openstack.org/159536 | 16:51 |
*** salv-orlando has quit IRC | 16:53 | |
*** koolhead17 has joined #openstack-doc | 16:53 | |
*** amotoki has joined #openstack-doc | 16:54 | |
*** Marga_ has joined #openstack-doc | 16:55 | |
*** Marga_ has quit IRC | 16:56 | |
*** Marga_ has joined #openstack-doc | 16:56 | |
*** amotoki has quit IRC | 17:02 | |
*** bdpayne has joined #openstack-doc | 17:03 | |
*** AJaeger has joined #openstack-doc | 17:03 | |
*** pm90_ has quit IRC | 17:06 | |
*** AJaeger has quit IRC | 17:06 | |
openstackgerrit | Nathaniel Dillon proposed openstack/security-doc: Adding clarification to Networking's security guide references. https://review.openstack.org/157162 | 17:12 |
*** etoews has quit IRC | 17:16 | |
*** annegentle has joined #openstack-doc | 17:18 | |
*** annegentle has quit IRC | 17:23 | |
*** linuxhermit has joined #openstack-doc | 17:29 | |
*** etoews has joined #openstack-doc | 17:31 | |
*** pdesai has joined #openstack-doc | 17:35 | |
*** Marga_ has quit IRC | 17:38 | |
*** igordcard has quit IRC | 17:38 | |
*** Marga_ has joined #openstack-doc | 17:38 | |
*** sgordon is now known as steveg | 17:44 | |
*** salv-orlando has joined #openstack-doc | 17:49 | |
*** matjazp has joined #openstack-doc | 17:54 | |
*** Marga_ has quit IRC | 17:56 | |
*** pdesai1 has joined #openstack-doc | 17:59 | |
*** pdesai has quit IRC | 18:02 | |
*** emagana has joined #openstack-doc | 18:03 | |
*** AJaeger has joined #openstack-doc | 18:05 | |
*** emagana has quit IRC | 18:07 | |
openstackgerrit | Andreas Jaeger proposed openstack/openstack-manuals: Use git.openstack.org https://review.openstack.org/159559 | 18:09 |
*** annegentle has joined #openstack-doc | 18:19 | |
AJaeger | annegentle: ping | 18:22 |
*** Aish has joined #openstack-doc | 18:22 | |
*** annegentle has quit IRC | 18:24 | |
*** patrickeast has joined #openstack-doc | 18:29 | |
openstackgerrit | Andreas Jaeger proposed openstack/docs-specs: Create guidelines for vendor drivers https://review.openstack.org/133372 | 18:31 |
AJaeger | fifieldt: could you review the spec again, please? | 18:31 |
openstackgerrit | Andreas Jaeger proposed openstack/docs-specs: Create guidelines for vendor driver documentation https://review.openstack.org/133372 | 18:33 |
openstackgerrit | Andreas Jaeger proposed openstack/docs-specs: Create guidelines for vendor driver documentation https://review.openstack.org/133372 | 18:36 |
*** matjazp has quit IRC | 18:37 | |
*** egallen has quit IRC | 18:38 | |
*** erikmwilson has quit IRC | 18:38 | |
*** erikwilson is now known as erikmwilson | 18:38 | |
openstackgerrit | AJAY KALAMBUR proposed openstack/training-guides: Fix interface bringup command to work for Ubuntu 14.04 This bug changes service networking restart command to ifup <interface> since service networking restart does not work anymore on Ubuntu 14.04 https://review.openstack.org/159572 | 18:45 |
*** Marga_ has joined #openstack-doc | 18:46 | |
*** Marga_ has quit IRC | 18:47 | |
*** Marga_ has joined #openstack-doc | 18:47 | |
*** Marga_ has quit IRC | 18:48 | |
*** Marga_ has joined #openstack-doc | 18:48 | |
*** coolsvap is now known as coolsvap_ | 18:48 | |
*** Marga_ has quit IRC | 18:49 | |
*** Marga_ has joined #openstack-doc | 18:49 | |
openstackgerrit | Andreas Jaeger proposed openstack/docs-specs: Create guidelines for vendor driver documentation https://review.openstack.org/133372 | 18:50 |
openstackgerrit | AJAY KALAMBUR proposed openstack/training-guides: Fix interface bringup command to work for Ubuntu 14.04 This bug changes service networking restart command to ifup <interface> since service networking restart does not work anymore on Ubuntu 14.04 https://review.openstack.org/159572 | 18:58 |
*** egallen has joined #openstack-doc | 18:58 | |
*** egallen has quit IRC | 18:59 | |
*** sayali1 has joined #openstack-doc | 19:00 | |
*** sayali has quit IRC | 19:01 | |
*** pdesai has joined #openstack-doc | 19:01 | |
*** sayali2 has joined #openstack-doc | 19:03 | |
*** pdesai1 has quit IRC | 19:03 | |
*** sayali1 has quit IRC | 19:04 | |
*** linuxhermit has left #openstack-doc | 19:06 | |
*** akalambu has joined #openstack-doc | 19:07 | |
*** sayali2 has quit IRC | 19:07 | |
*** koolhead17 has quit IRC | 19:09 | |
*** akalambu_ has joined #openstack-doc | 19:13 | |
*** erikwilson has joined #openstack-doc | 19:14 | |
*** erikmwilson is now known as Guest55155 | 19:14 | |
*** erikwilson is now known as erikmwilson | 19:14 | |
*** etoews has quit IRC | 19:14 | |
*** erikmwilson has quit IRC | 19:15 | |
*** erikmwilson has joined #openstack-doc | 19:15 | |
*** akalambu_ has quit IRC | 19:17 | |
*** coolsvap_ is now known as coolsvap | 19:21 | |
*** etoews has joined #openstack-doc | 19:21 | |
*** akalambu has quit IRC | 19:24 | |
*** etoews has quit IRC | 19:24 | |
*** akalambu has joined #openstack-doc | 19:25 | |
*** matjazp has joined #openstack-doc | 19:26 | |
*** koolhead17 has joined #openstack-doc | 19:37 | |
*** koolhead17 has quit IRC | 19:37 | |
*** koolhead17 has joined #openstack-doc | 19:37 | |
*** jecarey has quit IRC | 19:43 | |
*** sayali2 has joined #openstack-doc | 19:43 | |
*** AJaeger has quit IRC | 19:43 | |
*** pdesai has quit IRC | 19:44 | |
*** matjazp has quit IRC | 19:49 | |
*** akalambu has quit IRC | 19:50 | |
*** matjazp has joined #openstack-doc | 19:54 | |
*** tyr_ has joined #openstack-doc | 19:56 | |
*** bdpayne_ has joined #openstack-doc | 19:58 | |
*** sayan has quit IRC | 19:59 | |
*** sayan has joined #openstack-doc | 20:00 | |
*** matjazp_ has joined #openstack-doc | 20:01 | |
*** bdpayne has quit IRC | 20:01 | |
*** bdpayne_ has quit IRC | 20:02 | |
openstackgerrit | Anne Gentle proposed openstack/openstack-manuals: Adds and corrects redirects for released location of training-guides https://review.openstack.org/159595 | 20:02 |
*** matjazp has quit IRC | 20:03 | |
*** jecarey has joined #openstack-doc | 20:03 | |
*** matjazp_ has quit IRC | 20:08 | |
*** matjazp has joined #openstack-doc | 20:08 | |
*** Harry51S has quit IRC | 20:13 | |
*** koolhead17 has quit IRC | 20:22 | |
*** bdpayne has joined #openstack-doc | 20:22 | |
*** jroll has joined #openstack-doc | 20:25 | |
*** pdesai has joined #openstack-doc | 20:25 | |
*** Marga_ has quit IRC | 20:28 | |
*** sayali2 has quit IRC | 20:28 | |
*** robindekens has joined #openstack-doc | 20:29 | |
*** sayali2 has joined #openstack-doc | 20:29 | |
*** bdpayne has quit IRC | 20:34 | |
*** bdpayne has joined #openstack-doc | 20:35 | |
*** robindekens has quit IRC | 20:37 | |
openstackgerrit | Sayali Lunkad proposed openstack/training-guides: Changes pre-config files to use new ssh keys https://review.openstack.org/158667 | 20:54 |
*** JRobinson__ has joined #openstack-doc | 20:57 | |
*** matjazp has quit IRC | 21:05 | |
*** jecarey_ has joined #openstack-doc | 21:14 | |
*** coolsvap is now known as coolsvap_ | 21:15 | |
*** jecarey has quit IRC | 21:17 | |
*** sayali2 has quit IRC | 21:20 | |
*** Marga_ has joined #openstack-doc | 21:29 | |
*** JRobinson__ has quit IRC | 21:32 | |
*** Marga_ has quit IRC | 21:33 | |
*** pdesai has quit IRC | 21:36 | |
*** Marga_ has joined #openstack-doc | 21:40 | |
*** SamYaple is now known as I-Am-Sam | 21:41 | |
*** I-Am-Sam is now known as SamYaple | 21:42 | |
*** matjazp has joined #openstack-doc | 21:46 | |
*** pdesai has joined #openstack-doc | 21:50 | |
*** jecarey_ is now known as jecarey | 21:56 | |
*** matjazp has quit IRC | 22:00 | |
*** stevemar is now known as thinksmorganneed | 22:13 | |
*** thinksmorganneed is now known as stevemar | 22:13 | |
*** erlon is now known as erlon_away | 22:21 | |
*** pdesai has quit IRC | 22:21 | |
*** pdesai has joined #openstack-doc | 22:22 | |
*** steveg is now known as sgordon | 22:30 | |
openstackgerrit | Danny Wilson proposed openstack/openstack-manuals: Update of Pure Storage Cinder document for Kilo https://review.openstack.org/159636 | 22:32 |
*** sayan has quit IRC | 22:40 | |
*** dnavale has joined #openstack-doc | 22:46 | |
*** adahms has joined #openstack-doc | 22:53 | |
openstackgerrit | Alexandra Settle proposed openstack/openstack-manuals: Removal of passive voice from chap 4, arch guide https://review.openstack.org/159648 | 23:00 |
openstackgerrit | Alexandra Settle proposed openstack/openstack-manuals: Removal of passive voice from chap 4, arch guide https://review.openstack.org/159660 | 23:16 |
*** mattfarina has quit IRC | 23:18 | |
*** stevemar has quit IRC | 23:19 | |
*** jecarey has quit IRC | 23:25 | |
*** pdesai1 has joined #openstack-doc | 23:30 | |
*** pdesai has quit IRC | 23:33 | |
openstackgerrit | Shail Bhargava proposed openstack/security-doc: MySQL SSL transport config example https://review.openstack.org/159668 | 23:40 |
*** amotoki has joined #openstack-doc | 23:43 | |
*** amotoki has quit IRC | 23:44 | |
*** KLevenstein has quit IRC | 23:44 | |
openstackgerrit | Shail Bhargava proposed openstack/security-doc: MySQL SSL transport config example https://review.openstack.org/159668 | 23:49 |
*** EmilienM is now known as EmilienM|afk | 23:49 | |
*** suyog has joined #openstack-doc | 23:51 | |
*** bmoss has joined #openstack-doc | 23:52 | |
*** chlong has joined #openstack-doc | 23:53 | |
*** tyr_ has quit IRC | 23:57 | |
*** tyr_ has joined #openstack-doc | 23:57 | |
*** salv-orlando has quit IRC | 23:57 | |
*** pdesai1 has quit IRC | 23:58 |
Generated by irclog2html.py 2.14.0 by Marius Gedminas - find it at mg.pov.lt!