As some of you might have noticed, Tyler and I tossed around a couple of
thoughts yesterday regarding the best way to perform larger reviews on JIRA.

I've been leaning towards the approach Benedict's been taking lately
w/putting comments inline on a branch for the initial author to inspect as
that provides immediate locality for a reviewer to write down their
thoughts and the same for the initial developer to ingest them. One
downside to that approach is that the extra barrier to entry makes it more
of a 1-on-1 conversation rather than an open discussion via JIRA comments.
Also, if one deletes branches from github we then lose our discussion
history on the review process which is a big problem for digging into why
certain decisions were made or revised during the process.

On the competing side, monster comments like this
<https://issues.apache.org/jira/browse/CASSANDRA-6477?focusedCommentId=14617221&page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#comment-14617221>
(which
is one of multiple to come) are burdensome to create and map into a JIRA
comment and, in my experience, also a burden to map back into the code-base
as a developer. Details are lost in translation; I'm comfortable labeling
this a sub-optimal method of communication.

So what to do?

-- 
Joshua McKenzie

Reply via email to