mirrors/git
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Merge branch 'jc/breaking-changes-early-adopter-option'

Browse Source 
Doc update.

* jc/breaking-changes-early-adopter-option:
  BreakingChanges: clarify the procedure
This commit is contained in:
Junio C Hamano
2025-03-05 10:37:45 -08:00
parent 3334de6494 c268e3285d
commit e2334d2f35
1 changed files with 5 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
Documentation/BreakingChanges.adoc
View File

@ -66,22 +66,21 @@ changes are made at a certain version boundary, and recording these
decisions in this document, are necessary but not sufficient. decisions in this document, are necessary but not sufficient.
Because such changes are expected to be numerous, and the design and Because such changes are expected to be numerous, and the design and
implementation of them are expected to span over time, they have to implementation of them are expected to span over time, they have to
be deployable trivially at such a version boundary. be deployable trivially at such a version boundary, prepared over long
time.
The breaking changes MUST be guarded with the a compile-time switch, The breaking changes MUST be guarded with the a compile-time switch,
WITH_BREAKING_CHANGES, to help this process. When built with it, WITH_BREAKING_CHANGES, to help this process. When built with it,
the resulting Git binary together with its documentation would the resulting Git binary together with its documentation would
behave as if these breaking changes slated for the next big version behave as if these breaking changes slated for the next big version
boundary are already in effect. We may also want to have a CI job boundary are already in effect. We also have a CI job to exercise
or two to exercise the work-in-progress version of Git with these the work-in-progress version of Git with these breaking changes.
breaking changes.
== Git 3.0 == Git 3.0
The following subsections document upcoming breaking changes for Git 3.0. There The following subsections document upcoming breaking changes for Git 3.0. There
is no planned release date for this breaking version yet. The early is no planned release date for this breaking version yet.
adopter configuration used for changes for this release is `feature.git3`.
Proposed changes and removals only include items which are "ready" to be done. Proposed changes and removals only include items which are "ready" to be done.
In other words, this is not supposed to be a wishlist of features that should In other words, this is not supposed to be a wishlist of features that should