Repository navigation
MINOR: adding changes guidelines - #645
Open
julienledem wants to merge 2 commits into
Open
julienledem wants to merge 2 commits into
julienledem wants to merge 2 commits into
Conversation
Signed-off-by: Julien Le Dem <julien.ledem@datadoghq.com>
Signed-off-by: Julien Le Dem <julien.ledem@datadoghq.com>
alamb
approved these changes
Nov 21, 2026
alamb
left a comment
Contributor
There was a problem hiding this comment.
Thank you @julienledem -- this looks like a nice step forward to me
As I think @emkornfield has mentioned before, we now have two sources of somewhat overlapping information (FormatChanges.md and the README) which would be nice to consolidate eventually
| See [Changing the Format](FormatChanges.md) for more details on the categories | ||
| of changes and the criteria used to evaluate them. | ||
|
|
||
| New features are intended to be widely beneficial to users of Parquet, and |
Contributor
There was a problem hiding this comment.
Perhaps as a follow on PR we can consolidate this text with the text in FormatChanges.md
divjotarora
reviewed
Nov 21, 2026
|
|
||
| ## Dealing with incompatible changes | ||
|
|
||
| ### Backward compatibility |
Contributor
There was a problem hiding this comment.
Should we mention something about deprecation here? If we intend to drop a field, we should likely be deprecating it in the current version so readers/writers have time to change if needed and then dropping it in the next version.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Rationale for this change
I created a page reflecting the content of the guidelines we have been discussing.
https://docs.google.com/document/d/19bOTy1WcLs9NP88DrysG4wG50pM6gmIFaSEWzkxUeJw/edit?tab=t.8veepidgez8a#heading=h.lkllwrkuv6vx
I initially opened it on parquet-site but moving it here, and now parquet-site renders content from this page
What changes are included in this PR?
This adds a page to the documentation
Do these changes have PoC implementations?
This is documentation.