Skip to content

Conversation

@alamb
Copy link
Contributor

@alamb alamb commented Nov 8, 2025

Which issue does this PR close?

Rationale for this change

As our releases have become more complex, it is important that our
release documentation reflects the current reality.
While working on the 51 release in #17558 I found
it was somewhat out of date (didn't refer to the branches, for example)

What changes are included in this PR?

Update readme

Are these changes tested?

N/A

Are there any user-facing changes?

No -- this is internal developer documentation

@alamb alamb added the development-process Related to development process of DataFusion label Nov 8, 2025
@alamb alamb marked this pull request as ready for review November 8, 2025 11:25
@alamb alamb requested review from Copilot and xudong963 November 8, 2025 11:25
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

This PR comprehensively reorganizes and updates the DataFusion release documentation to improve clarity and accuracy. The changes restructure the content with clearer headings, update example version numbers to more recent releases (e.g., from 38.x to 50.x/51.x), and provide more detailed step-by-step instructions.

  • Reorganized document structure with clearer sections: "Release Process Overview", "Release Prerequisites", and numbered step-by-step release instructions
  • Updated all example commands and version references to use more current version numbers (50.x, 51.x instead of 37.x, 38.x)
  • Enhanced prerequisite documentation with detailed setup instructions for GitHub PATs, GPG keys, and git remotes

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copy link
Contributor

@mbutrovich mbutrovich left a comment

Choose a reason for hiding this comment

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

Minor nits, thanks for updating this @alamb. Maybe I can work through these for the next patch release since they'll be fresh eyes to the process.

Co-authored-by: Matt Butrovich <[email protected]>
Co-authored-by: Copilot <[email protected]>
Copy link
Contributor Author

@alamb alamb left a comment

Choose a reason for hiding this comment

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

Thank you @mbutrovich !

- After the release is approved, we publish to crates.io, the ASF distribution servers, and GitHub tags.

For patch releases, we backport changes from `main` to the release branch as
needed and repeat the release process as needed.
Copy link
Member

Choose a reason for hiding this comment

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

Another step in my mind is to forward port, like this PR: https://github.com/apache/datafusion/pull/18057/files

Copy link
Contributor Author

Choose a reason for hiding this comment

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

This is a good call -- I added this to the description in ca08f4f

github-merge-queue bot pushed a commit that referenced this pull request Nov 11, 2025
## Which issue does this PR close?

- part of #17558
- Related to #18549

## Rationale for this change

While working on #18549 I
noticed that the release download page was out of date

https://datafusion.apache.org/download.html

<img width="816" height="456" alt="Screenshot 2025-11-08 at 6 31 50 AM"
src="https://github.com/user-attachments/assets/4678bc8e-0d85-4951-91af-3b1c0ee00a26"
/>


## What changes are included in this PR?

Update links (I will comment more inline)

## Are these changes tested?

I manually rendered the page:

<img width="846" height="869" alt="Screenshot 2025-11-08 at 6 39 00 AM"
src="https://github.com/user-attachments/assets/e8312c7c-b4af-43f9-9767-ae234c08c928"
/>


## Are there any user-facing changes?

Updated download page that is not outdated
Copy link
Member

@xudong963 xudong963 left a comment

Choose a reason for hiding this comment

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

Thank you @alamb

@xudong963 xudong963 added this pull request to the merge queue Nov 11, 2025
Merged via the queue into apache:main with commit d57e215 Nov 11, 2025
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

development-process Related to development process of DataFusion

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants