@@ -37,11 +37,12 @@ again, the minimum deprecation window in
3737revision in which the new deprecation takes effect.
3838
3939### SDKs
40+
4041Removal from the specification does not oblige an SDK to drop the feature from
4142releases. That timeline is governed by the SDK's own revision-support policy.
4243
43-
4444## Deprecating a Feature
45+
4546A feature may be proposed for deprecation due to
4647
4748- it has been superseded by another feature that covers the same use cases,
@@ -60,7 +61,7 @@ Deprecation is a specification change and therefore requires a SEP per the
60613 . Document the migration path, or state explicitly that none is required. If
6162 the migration path names a replacement feature, that feature must be Active
6263 in the revision in which the deprecation takes effect; the replacement and
63- the deprecation may land in the same revision.
64+ the deprecation may land in the same revision.
64654 . Specify the ** minimum deprecation window** : the number of months, at least
6566 twelve, that the feature must remain Deprecated before it is eligible for
6667 removal. The window is measured from the release of the specification
@@ -69,7 +70,7 @@ Deprecation is a specification change and therefore requires a SEP per the
6970 specification revision released as Current on or after the window elapses;
7071 that point is the feature's ** earliest removal** .
7172
72- When the deprecation SEP is accepted and reaches Final, the deprecation is scheduled.
73+ When the deprecation SEP is accepted and reaches Final, the deprecation is scheduled.
7374
7475- The feature's entry in ` schema.ts ` gains a ` @deprecated ` JSDoc tag
7576 referencing the deprecation SEP and the revision in which the deprecation
@@ -86,15 +87,15 @@ When the deprecation SEP is accepted and reaches Final, the deprecation is sched
8687
8788The feature becomes Deprecated when the revision carrying these changes is released
8889and becomes the new Current revision (see [ versioning guide] ( /docs/learn/versioning ) ).
89- The minimum deprecation window is counted from that release.
90+ The minimum deprecation window is counted from that release.
9091
9192## The Deprecated Registry
9293
9394[ ` docs/specification/draft/deprecated.mdx ` ] ( /specification/draft/deprecated ) is
9495a single page listing every feature Deprecated or Removed state. It is
9596the canonical answer to "what is on its way out, and by when," so that an
9697implementer does not have to reconstruct that picture from deprecation entries
97- spread across revision changelogs.
98+ spread across revision changelogs.
9899
99100## Tier 1 SDK Obligations
100101
@@ -105,18 +106,18 @@ released as Current, Tier 1 SDKs:
105106 native mechanism (for example ` @Deprecated ` in Java, ` [Obsolete] ` in .NET,
106107 ` @deprecated ` JSDoc in TypeScript, the ` Deprecated: ` doc convention in Go) in
107108 their next release, referencing the deprecation SEP and the earliest removal
108- date where the mechanism permits.
109+ date where the mechanism permits.
109110- Should emit a runtime warning when a deprecated feature is exercised, using
110111 the language's idiomatic mechanism (for example Python's
111112 ` DeprecationWarning ` , Node.js's ` process.emitWarning ` , or a configurable
112- logger).
113+ logger).
113114
114115## Removing a Feature
115116
1161171 . Once a feature is set for removal, the removal is executed at the discretion
117118 of the Core Maintainers after the minimum deprecation window has elapsed.
1181192 . The removal needs to be documented in the ` changelog.mdx ` and [ registry] ( #the-deprecated-regsitry )
119- 2 . A SEP is required for any change to the original deprecation or removal SEP, for
120+ 3 . A SEP is required for any change to the original deprecation or removal SEP, for
120121 example extending or shortening the timeline
121122 ([ Expedited removal] ( #expedited-removal ) ) or restoring the feature to Active
122123 ([ Feature states] ( #feature-states ) ).
0 commit comments