Skip to content

chore: Define backport criteria#22766

Merged
comphead merged 3 commits into
apache:mainfrom
comphead:backport
Jun 10, 2026
Merged

chore: Define backport criteria#22766
comphead merged 3 commits into
apache:mainfrom
comphead:backport

Conversation

@comphead

@comphead comphead commented Jun 4, 2026

Copy link
Copy Markdown
Contributor

Which issue does this PR close?

Rationale for this change

What changes are included in this PR?

Are these changes tested?

Are there any user-facing changes?

@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Jun 4, 2026

@alamb alamb left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you @comphead -- this looks good to me and I think reflects what we normally do for Datafusion releases

### Behavior changes

A "behavior change" is any fix that alters user-visible results: SQL
semantics (values, ordering, types, null handling), error messages that

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we have made error message changes in minor releases before and it seems like that would be ok to me, to be honest.

The rest of this sounds good

Comment on lines +112 to +118
returning different results. Before opening the backport PR:

1. State on the release tracking issue _why_ the change must ship in this
patch release rather than the next major.
2. Describe the previous and new behavior with example queries and results.
3. Wait for explicit acknowledgment from the release manager or another
committer on the tracking issue.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am not sure we need to gate the creation of a backport PR on acknowledgement from the release manager -- making the backport PR is pretty simple, and I would expect that 2. (describing previous behavior, etc) would have already been done on the main issue

Explaining why you want the change in the patch release is a good idea though.


### Who decides

The release manager for the active release line is the final reviewer of

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think practically any committer can commit to a release branch too -- so maybe we can make ti clear that others can merge PRs to the release branch, though the release manager will review them

Comment thread docs/source/contributor-guide/release_management.md
comphead and others added 2 commits June 9, 2026 16:36
EdsonPetry pushed a commit to EdsonPetry/datafusion that referenced this pull request Jun 9, 2026
…22822)

## Which issue does this PR close?

- Part of  apache#22765
- Related to apache#19783.


## Rationale for this change

While reviewing apache#22766 from
@comphead I noticed that the release management guide did not point
contributors to the ongoing release tracking issue, where planned
releases are listed.

## What changes are included in this PR?

This PR adds a link to the DataFusion Releases tracking issue from the
release management guide and clarifies that each release is coordinated
in a dedicated GitHub issue.

## Are these changes tested?

Not run. This is a documentation-only change.

## Are there any user-facing changes?

No API or behavior changes. This updates contributor documentation only.
@comphead

Copy link
Copy Markdown
Contributor Author

Concern we running code CI for documentation PRs, which doesn't make a lot of sense.

@comphead comphead added this pull request to the merge queue Jun 10, 2026
@comphead

Copy link
Copy Markdown
Contributor Author

Thanks @alamb for the review

Merged via the queue into apache:main with commit d0ee6b5 Jun 10, 2026
36 checks passed
@comphead comphead deleted the backport branch June 10, 2026 00:13
AdamGS pushed a commit to AdamGS/arrow-datafusion that referenced this pull request Jun 11, 2026
…22822)

## Which issue does this PR close?

- Part of  apache#22765
- Related to apache#19783.


## Rationale for this change

While reviewing apache#22766 from
@comphead I noticed that the release management guide did not point
contributors to the ongoing release tracking issue, where planned
releases are listed.

## What changes are included in this PR?

This PR adds a link to the DataFusion Releases tracking issue from the
release management guide and clarifies that each release is coordinated
in a dedicated GitHub issue.

## Are these changes tested?

Not run. This is a documentation-only change.

## Are there any user-facing changes?

No API or behavior changes. This updates contributor documentation only.
AdamGS pushed a commit to AdamGS/arrow-datafusion that referenced this pull request Jun 11, 2026
## Which issue does this PR close?

<!--
We generally require a GitHub issue to be filed for all bug fixes and
enhancements and this helps us generate change logs for our releases.
You can link an issue to this PR using the GitHub syntax. For example
`Closes apache#123` indicates that this PR will close issue apache#123.
-->

- Closes apache#22765 .

## Rationale for this change

<!--
Why are you proposing this change? If this is already explained clearly
in the issue then this section is not needed.
Explaining clearly why changes are proposed helps reviewers understand
your changes and offer better suggestions for fixes.
-->

## What changes are included in this PR?

<!--
There is no need to duplicate the description in the issue here but it
is sometimes worth providing a summary of the individual changes in this
PR.
-->

## Are these changes tested?

<!--
We typically require tests for all PRs in order to:
1. Prevent the code from being accidentally broken by subsequent changes
2. Serve as another way to document the expected behavior of the code

If tests are not included in your PR, please explain why (for example,
are they covered by existing tests)?
-->

## Are there any user-facing changes?

<!--
If there are user-facing changes then we may require documentation to be
updated before approving the PR.
-->

<!--
If there are any breaking changes to public APIs, please add the `api
change` label.
-->

---------

Co-authored-by: Andrew Lamb <andrew@nerdnetworks.org>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

chore: discuss Backport criteria

2 participants