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