Thanks for your reply, Vladimir.
On 11/29/21 4:44 PM, Vladimir Sitnikov wrote:
Do you think Calcite has something unique in the release process that makes
GitHub infeasible?
Nope, just calling attention that we want releases to be "easy" to make
and anyone should be able to make them (not just someone who has done
one before)
Apparently, issues and PRs can be assigned to a milestone.
Apparently, committers can close the milestone.
I'll acknowledge that I'm asking a vague question that you probably
don't have an answer to :). I think the easiest thing is to focus on the
"workflow" for each "persona" we have:
* contributor
* developer
* release manager
For each of these people, define a contrived scenario and just make a
list of what steps they would do. For example, what would a contributor
do on Github to provide a patch for a bug they found? What about a
contributor reporting an issue? How should a developer structure a "big"
change to Calcite which might contain multiple commits? Where does a
release manager look to determine if a release is ready (all necessary
issues are fixed)?
This doesn't need to be a perfect or exhaustive list, but having
something to reference (which others can then use/modify/update) would
be a huge help for the whole community.
I'm a little confused in your original message, you have two questions.
Are you suggesting that Calcite would use both Jira and Github issues?
No way. I think we should move all issue management to GitHub.
I just thought that questions like "should we keep JIRA" or "should we move
to GitHub" might
provoke slightly different discussions with helpful comments even though it
is basically the same question.
Gotcha. I definitely think we need to have exactly one system.
Should PRs always have issues or is a PR sufficient
for inclusion in a release?
I believe, the current development workflow allows:
* PR without JIRA
* commits without PR
* commits without PR and JIRA (just commits)
It is up to the committer if the change is significant enough to have JIRA
or PR or whatever.
Writing down what you believe to be "allowed" and making sure everyone
else is on the same page is perfect.