I like the idea of encouraging regular contributors to use JIRA more consistently
On Wed, Feb 17, 2021 at 4:47 PM Wes McKinney <wesmck...@gmail.com> wrote: > For trivial PRs that do not merit mention in the changelog you could > preface the issue title with something like "ARROW-XXX" and we can > modify the merge tool to bypass the consistency check for these. I > think some other Apache projects do this. I can understand how it > might seem like a nuisance to get a Jira when fixing a typo in a > README, so this is easy to fix. > > For contributors doing non-trivial work, I think we want to try to get > people in the habit of putting out there what they are working on. > That's the thing that's most consistent with "The Apache Way" — write > things down, make plans in the open, allow others to see what is going > on and not have the roadmap existing exclusively in people's minds. > > On Wed, Feb 17, 2021 at 3:41 PM Andrew Lamb <al...@influxdata.com> wrote: > > > > Thanks for the background Wes. This is exactly what I was looking for. > > > > I think using JIRA for the single source of truth / project management > has > > lots of value and I don't want to propose changing that. I am trying to > > lower the barrier to contributing to Arrow even more. > > > > While I agree creating JIRA tickets is not hard, it is simply a few more > > steps for every PR and every contributor. The overhead is that much more > if > > you don't already have a JIRA account -- if I can avoid just a few more > > steps and get a few more contributors I will consider it a win. > > > > Given this info, I will do some research into the technical options, and > > make a more concrete proposal / prototype for automation in a while. > > > > Thanks again, > > Andrew > > > > On Wed, Feb 17, 2021 at 1:28 PM Wes McKinney <wesmck...@gmail.com> > wrote: > > > > > hi Andrew, > > > > > > There isn't a hard requirement. It's a culture thing where the purpose > > > of Jira issues is to create a changelog and for developers to > > > communicate publicly what work they are proposing to perform in the > > > project. We decided by consensus (essentially) that having a single > > > point of truth for developer activity in the project was a good idea. > > > > > > On Wed, Feb 17, 2021 at 12:09 PM Andrew Lamb <al...@influxdata.com> > wrote: > > > > > > > > Can someone tell me / point me at what the actual "requirements" for > > > using > > > > JIRA in Apache Arrow are? > > > > > > > > Specifically, I would like to know: > > > > > > > > 1. Where does the requirement for each commit to have a JIRA ticket > come > > > > from? (Is that Apache Arrow specific, or is it a more general Apache > > > > governance requirement? Something else?) > > > > > > > > 2. Does each commit need to be associated with a specific JIRA user > > > > account, or is a github username sufficient? > > > > > > We would prefer that issues be assigned to a Jira user. If you want to > > > create an issue on behalf of an uncooperative person and assign it to > > > yourself, you can do that, too. > > > > > > > Background: I am following up on an item raised at the Arrow Sync > call > > > > today and trying to determine how much of the current required Arrow > JIRA > > > > process could be automated. Micah mentioned that the JIRA specifics > might > > > > be related to ASF governance process or requirements, and I am > trying to > > > > research what those are. > > > > > > We could easily automate the creation of a Jira issue using a bot of > > > some kind. I don't think that creating issue is a hardship, though > > > (having created thousands of them myself over the last 5 years). My > > > position is that the hardship exists in the mind of the user and isn't > > > actually real. It would be better if contributors would indicate the > > > work they are proposing to contribute to the project before opening a > > > pull request (so that others know that someone is working on > > > something), but I understand that not everyone is going to do that. > > > > > > > I googled around but could not find anything at the Arrow or ASF > level > > > > about *WHY* Arrow has the current JIRA process requirements (though > the > > > > required process itself is well documented): > > > > > > > > Places I looked > > > > * https://infra.apache.org/policies.html > > > > * > > > > > > > > https://arrow.apache.org/docs/developers/contributing.html#report-bugs-and-propose-features > > > > * http://www.apache.org/licenses/contributor-agreements.html > > > > * http://www.apache.org/licenses/cla-faq.html > > > > * various google searches > > > > > > > > I apologize if I missed something obvious. > > > > > > > > Any help would be most appreciated, > > > > Andrew > > > >
