Skip to content
Open
Changes from 1 commit
Commits
Show all changes
29 commits
Select commit Hold shift + click to select a range
5e4a08c
Add changes to the release process
bukka May 9, 2025
b92c3c0
Reword minor version changes (feedback from Tim)
bukka May 9, 2025
9b9c4f2
Define BC and fix typo
bukka May 9, 2025
b338ee2
Update formatting
bukka May 12, 2025
a706a85
Address feedback and properly use key words
bukka May 13, 2025
20dc00d
Update syntaxt backward compatiblity note
bukka May 13, 2025
c897ed7
Add note about UPGRADING and extend symbol rule
bukka May 13, 2025
5a4bdb7
Move notation from coding standard and update updated by
bukka May 13, 2025
20445c7
Move source to note
bukka May 13, 2025
5510a61
Usa table for sources
bukka May 13, 2025
22cabf3
Update table formatting
bukka May 13, 2025
dfa7a39
Fix formatting a bit more
bukka May 13, 2025
6eda868
Fix table formatting
bukka May 13, 2025
e54b88b
Address feedback from Ilija and Jorg
bukka May 27, 2025
2ab125c
Update major version list
bukka May 27, 2025
7907392
Add notes about SAPI support and removal
bukka Jun 10, 2025
a6cd532
Extend recommendations for minor version breaks
bukka Jun 24, 2025
d9acb51
Use "these documents" in README
bukka Jun 24, 2025
1bc0718
Add minor changes to the rules to address latest comments
bukka Jul 16, 2025
401fde1
Fix CS
bukka Jul 16, 2025
a8512e7
Remove superfluous the
bukka Jul 16, 2025
97833c8
Update rules for security branches fixes
bukka Jul 22, 2025
66f4ed7
Update the Backward Compatibility definition
bukka Aug 1, 2025
f29eda3
Add major version bump info
bukka Aug 1, 2025
933f593
Update valid interpretation
bukka Aug 1, 2025
0f5048d
Move the BC about bugs to exception
bukka Aug 1, 2025
2081c38
Fix wording in patch version rulse
bukka Sep 9, 2025
26b7c18
Extend and improve BC breaks and some other parts
bukka Sep 9, 2025
053be25
Use maintained instead of preserved
bukka Sep 9, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 9 additions & 3 deletions release-process.rst
Original file line number Diff line number Diff line change
Expand Up @@ -37,9 +37,15 @@ No feature addition after final x.y.0 release (or x.0.0).
Backward Compatibility
======================

A backward compatibility (BC) break is defined as any change that prevents
existing, valid, userland code from continuing to behave as it did in a previous
version within the same major release.
A backward compatibility (BC) break is any change that causes existing userland
code, which was previously considered valid, to behave differently than before.
This includes changes that result in different output, trigger new errors, or
otherwise alter the observable behavior of the code.

In this context, valid userland code refers to code that compiled and executed
in a previous version without fatal errors. It may or may not have relied on
buggy or unintended behavior. The key consideration is whether the change alters
the behavior in a way that existing code might have come to depend on.

Compatibility Terminology
-------------------------
Expand Down