Is ReviewBoard a good thing?
Jesse Meek
jesse.meek at canonical.com
Tue Sep 23 08:52:39 UTC 2014
Thanks Nate and Eric,
Those steps look much better. The contributor will still need to log
into review board and find their way around a new interface to respond
to comments etc. But, let's leave this for Brussels.
On 23/09/14 04:00, Nate Finch wrote:
> So, the automation between github and reviewboard seems necessary, so
> we should do that. It shouldn't be hard at all. Then the steps for
> submitting code will be:
>
> 1.) Submit a PR
> 2.) Get it reviewed on the automatically-created review.
> 3.) With a LGTM on the review, mark as $$merge$$ and the bot merges it.
> 4.) There is no step 4.
>
> Note that this is the exactly the same steps if the review is on
> github or reviewboard.
>
> Then we can just address the pros and cons of each without worrying
> about the impact on workflow.
>
> Github pros:
>
> * Comfortable for people who only know github.
> * Slightly more "visible" since the reviews happen right on github.
>
> Reviewboard pros:
>
> * Far less email spam.
> * Better handling of updated code mid-review.
> * Supports chained reviews.
> * Customizable.
>
> Let me know if I missed anything, but this still seems like
> Reviewboard is the way to go.
>
> And yes, let's please continue to trial it until we can discuss in
> Brussels. We can always trivially switch back to github if/when we
> want to.
>
>
> On Mon, Sep 22, 2014 at 11:05 AM, Eric Snow <eric.snow at canonical.com
> <mailto:eric.snow at canonical.com>> wrote:
>
> On Sat, Sep 20, 2014 at 12:01 AM, Jesse Meek
> <jesse.meek at canonical.com <mailto:jesse.meek at canonical.com>> wrote:
> > On 20/09/14 02:34, Eric Snow wrote:
> > I was not seriously suggesting we return to lp. Using ReviewBoard
> > reintroduces what we gave up with lp: both the good (tooling
> that addresses
> > pain points) and the bad (not a well known/widely adopted process of
> > contributing). In this regard, using ReviewBoard is akin to
> returning to lp.
>
> Sorry, I misread. Thanks for clarifying.
>
> >
> > It is not a question of "does ReviewBoard address our pain
> points" nor is it
> > a question of "is this just teething?". Both valid questions in
> their own
> > right, but they miss the point. Is raising the bar to outside
> contributors
> > necessary and justified?
>
> What do you mean by raising the bar? If you mean the extra steps
> we've introduced for reviewboard, I agree to the extent that we do not
> yet have any automation between github and reviewboard, and we must
> take the steps manually. However, once we have automated those steps
> it will be a non-issue.
>
> Furthermore, I will argue that reviewboard provides a better code
> review experience than github. That's a relatively subjective
> assessment, but there are also concrete benefits that I hope I've
> outlined well in the "pros and cons" thread.
>
> FWIW, I do not plan on updating the CONTRIBUTING doc until after we
> have github-reviewboard automation in place. Until then outside
> contributers won't have to worry about reviewboard. And afterward
> they still won't have to worry about more than simply following the
> link to the review request for their PR.
>
> >
> > Is it necessary? Many of us have addressed our own pain points
> with GitHub
> > already. I use browser plugins, git hooks and scripts to augment my
> > workflow.
>
> I'd be interested to know what folks are using to work around the
> deficiencies in github (reviews or otherwise). I expect such things
> would be generally useful. Ideally no one would need to worry about
> such workarounds, which is what we're trying to address via
> reviewboard, but I expect that any such tools would be useful,
> reviewboard or not.
>
> > Yet I can work along side the first time contributor that has
> > nothing more than git and a GitHub account. What pain point
> necessitates
> > raising the bar to contributors?
>
> I agree that, without the github-reviewboard automation, any
> requirements to use reviewboard are more roadblocks to contribution.
>
> >
> > Is it justified? Given such a pain point exists, does solving it
> justify
> > *forcing* a new tool on a developer? This is the decision we are
> making and
> > it is not just for 'us' the team. It is for our would-be external
> > contributors. The ones that we moved to GitHub for.
>
> I'm glad you spoke up on this. It's important we keep this firmly in
> mind when making any changes to workflow. FYI, I had a patch for
> CONTRIBUTING.md that updated the workflow relative to the new
> reviewboard steps/tooling. However, you've convinced me to abandon it
> in favor of simply waiting until we have automation in place, to avoid
> adding barriers to entry. Thanks. :)
>
> -eric
>
> --
> Juju-dev mailing list
> Juju-dev at lists.ubuntu.com <mailto:Juju-dev at lists.ubuntu.com>
> Modify settings or unsubscribe at:
> https://lists.ubuntu.com/mailman/listinfo/juju-dev
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.ubuntu.com/archives/juju-dev/attachments/20140923/7b4f9cc0/attachment.html>
More information about the Juju-dev
mailing list