@@ -21,11 +21,11 @@ Alpha are off by default, and must be enabled by a feature flag, for example
2121removal or breaking changes without notice** , and generally not considered ready
2222for use in production.
2323
24- In some cases alpha features require fields be added to existing beta or GA
2524<!-- vale alex.Condescending = NO -->
25+ In some cases alpha features require fields be added to existing beta or GA
2626API types. In these cases fields must clearly be marked (for instance in their OpenAPI
27- <!-- vale alex.Condescending = YES -->
2827schema) as alpha and subject to alpha API constraints (or lack thereof).
28+ <!-- vale alex.Condescending = YES -->
2929
3030All alpha features should have an issue tracking their graduation to beta.
3131
@@ -42,11 +42,11 @@ instructions for migrating to the next version. This may require deleting,
4242editing, and recreating API objects. The editing process may require some
4343thought. This may require downtime for applications that rely on the feature.
4444
45- In some cases beta features require fields be added to existing GA API types. In
4645<!-- vale alex.Condescending = NO -->
46+ In some cases beta features require fields be added to existing GA API types. In
4747these cases fields must clearly be marked (for instance in their OpenAPI schema) as beta
48- <!-- vale alex.Condescending = YES -->
4948and subject to beta API constraints (or lack thereof).
49+ <!-- vale alex.Condescending = YES -->
5050
5151All beta features should have an issue tracking their graduation to GA.
5252
0 commit comments