openstack-doc-core team mailing list archive

[Anne Gentle <anne@xxxxxxxxxxxxx>]

I was thinking a mailing list message should be the first step in
education. The next step will be for us to really respond so we
motivate people to add DocImpact to their commit messages because
we're so awesome and responsive. :) Other ideas welcome, though.

The review for the addition is here:

https://review.openstack.org/#/c/9037/

My only remaining question to Clark of the CI team is "when is
notification sent?" - and the patchset he's proposing only sends after
the patch lands. I'd prefer notification early, such as trigger when
the patchset is created, even if it's a little "noisy" at first. Does
that sound okay?

Thanks,

Anne

On Wed, Jun 27, 2012 at 4:02 PM, Lorin Hochstein
<lorin@xxxxxxxxxxxxxxxxxx> wrote:
>
> On Jun 26, 2012, at 5:35 PM, Anne Gentle wrote:
>
> Hi all -
> I wanted to give status updates on some in-flight items since I'm on
> vacation for a while and we'll have our next doc team meeting right
> after I get back, July 10. So, here goes:
>
> DocImpact flag - The CI team is designing a flag system integrated
> into Gerrit that'll work something like this:
> 1. Developer makes a patch and submits it to one of the OpenStack projects.
> 2. Developer puts "DocImpact" somewhere in the commit message.
> 3. A Gerrit hook sends an email with a review.openstack.org link to
> the openstack-doc-core@xxxxxxxxxxxxxxxxxxx email.
> 4. A member of the doc team can click through on the
> review.openstack.org link to take a look at the patch and determine
> whether to log a Doc Bug (as a task), review the patch if it contains
> docs, or some other action.
> Any discussion on this new flag implementation?
>
>
>
> Neat-o. How can we educate the committers about its use? My first thought
> would be to ask the CI team to add some text to the Gerrit review pages, but
> committers don't see that page until after they've submitted the patch for
> merge.
>
>
>
> Take care,
>
> Lorin
> --
> Lorin Hochstein
> Lead Architect - Cloud Services
> Nimbis Services, Inc.
> www.nimbisservices.com
>
>
>
>