Skip to content

Commit e2a1178

Browse files
Update API_VERSIONING.md to remove ambiguity. (#40022)
I thought the original statement is kind of ambiguous "...Envoy and the larger xDS ecosystem ...is too widely used to make version bumps realistic." could be understood as "too widely used" as a facilitator of version bumps (instead of a barrier to version bumps). One could also have said "...Envoy and the larger xDS ecosystem ...is too widely used to make version bumps unrealistic." where "too widely used" is being presented as a barrier to version bumps. I just rewrote to make it absolutely clear Signed-off-by: sanjaypujare <[email protected]> Mirrored from https://github.com/envoyproxy/envoy @ bd8ff0930d96d27ac2c19bdf26a47df06baa88cf
1 parent 8dc607e commit e2a1178

File tree

1 file changed

+4
-4
lines changed

1 file changed

+4
-4
lines changed

API_VERSIONING.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -80,10 +80,10 @@ implementations within a major version should set explicit values for these fiel
8080

8181
At one point, the Envoy project planned for regular major version updates to the xDS API in order to
8282
remove technical debt. At this point we recognize that Envoy and the larger xDS ecosystem (gRPC,
83-
etc.) is too widely used to make version bumps realistic. As such, for practical purposes, the v3
84-
API is the final major version of the API and will be supported forever. Deprecations will still
85-
occur as an end-user indication that there is a preferred way to configure a particular feature, but
86-
no field will ever be removed nor will Envoy ever remove the implementation for any deprecated
83+
etc.) is so widely used that version bumps are no longer realistic. As such, for practical purposes,
84+
the v3 API is the final major version of the API and will be supported forever. Deprecations will
85+
still occur as an end-user indication that there is a preferred way to configure a particular feature,
86+
but no field will ever be removed nor will Envoy ever remove the implementation for any deprecated
8787
field.
8888

8989
**NOTE**: Client implementations are free to output additional warnings about field usage beyond

0 commit comments

Comments
 (0)