[openstack-dev] [tc][all] A culture change (nitpicking)
Amy Marrich
amy at demarco.com
Mon Jun 4 21:28:28 UTC 2018
Zane,
Not sure it is to be honest.:)
Amy (spotz)
On Mon, Jun 4, 2018 at 7:29 AM, Zane Bitter <zbitter at redhat.com> wrote:
> On 04/06/18 10:19, Amy Marrich wrote:
>
>> Zane,
>>
>> I'll read in more detail, but do we want to add rollcall-vote?
>>
>
> Is it used anywhere other than in the governance repo? We certainly could
> add it, but it didn't seem like a top priority.
>
> - ZB
>
> Amy (spotz)
>>
>>
>> On Mon, Jun 4, 2018 at 7:13 AM, Zane Bitter <zbitter at redhat.com <mailto:
>> zbitter at redhat.com>> wrote:
>>
>> On 31/05/18 14:35, Julia Kreger wrote:
>>
>> Back to the topic of nitpicking!
>>
>> I virtually sat down with Doug today and we hammered out the
>> positive
>> aspects that we feel like are the things that we as a community
>> want
>> to see as part of reviews coming out of this effort. The
>> principles
>> change[1] in governance has been updated as a result.
>>
>> I think we are at a point where we have to state high level
>> principles, and then also update guidelines or other context
>> providing
>> documentation to re-enforce some of items covered in this
>> discussion... not just to educate new contributors, but to serve
>> as a
>> checkpoint for existing reviewers when making the decision as to
>> how
>> to vote change set. The question then becomes where would such
>> guidelines or documentation best fit?
>>
>>
>> I think the contributor guide is the logical place for it. Kendall
>> pointed out this existing section:
>>
>> https://docs.openstack.org/contributors/code-and-documentati
>> on/using-gerrit.html#reviewing-changes
>> <https://docs.openstack.org/contributors/code-and-documentat
>> ion/using-gerrit.html#reviewing-changes>
>>
>> It could go in there, or perhaps we separate out the parts about
>> when to use which review scores into a separate page from the
>> mechanics of how to use Gerrit.
>>
>> Should we explicitly detail the
>> cause/effect that occurs? Should we convey contributor
>> perceptions, or
>> maybe even just link to this thread as there has been a massive
>> amount
>> of feedback raising valid cases, points, and frustrations.
>>
>> Personally, I'd lean towards a blended approach, but the question
>> of
>> where is one I'm unsure of. Thoughts?
>>
>>
>> Let's crowdsource a set of heuristics that reviewers and
>> contributors should keep in mind when they're reviewing or having
>> their changes reviewed. I made a start on collecting ideas from this
>> and past threads, as well as my own reviewing experience, into a
>> document that I've presumptuously titled "How to Review Changes the
>> OpenStack Way" (but might be more accurately called "The Frank
>> Sinatra Guide to Code Review" at the moment):
>>
>> https://etherpad.openstack.org/p/review-the-openstack-way
>> <https://etherpad.openstack.org/p/review-the-openstack-way>
>>
>> It's in an etherpad to make it easier for everyone to add their
>> suggestions and comments (folks in #openstack-tc have made some
>> tweaks already). After a suitable interval has passed to collect
>> feedback, I'll turn this into a contributor guide change.
>>
>> Have at it!
>>
>> cheers,
>> Zane.
>>
>>
>> -Julia
>>
>> [1]: https://review.openstack.org/#/c/570940/
>> <https://review.openstack.org/#/c/570940/>
>>
>>
>> ____________________________________________________________
>> ______________
>> OpenStack Development Mailing List (not for usage questions)
>> Unsubscribe:
>> OpenStack-dev-request at lists.openstack.org?subject:unsubscribe
>> <http://OpenStack-dev-request@lists.openstack.org?subject:unsubscribe
>> >
>> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
>> <http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev>
>>
>>
>>
>>
>> ____________________________________________________________
>> ______________
>> OpenStack Development Mailing List (not for usage questions)
>> Unsubscribe: OpenStack-dev-request at lists.openstack.org?subject:unsubscrib
>> e
>> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
>>
>>
>
> __________________________________________________________________________
> OpenStack Development Mailing List (not for usage questions)
> Unsubscribe: OpenStack-dev-request at lists.openstack.org?subject:unsubscribe
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20180604/020d411e/attachment.html>
More information about the OpenStack-dev
mailing list