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 > >
