Skip to content

Commit cfba564

Browse files
committed
doc: allow deprecations while a release is Current
Deprecations can land while a release line is Current, but not in Active LTS or Maintenance, and count as a cycle for that release. Signed-off-by: Matteo Collina <hello@matteocollina.com>
1 parent 1709394 commit cfba564

1 file changed

Lines changed: 10 additions & 4 deletions

File tree

doc/contributing/collaborator-guide.md

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -539,12 +539,18 @@ example, due to removal of an End-of-Life deprecated API).
539539

540540
<a id="deprecation-cycle"></a>
541541
A _deprecation cycle_ is a major release during which an API has been in one of
542-
the three Deprecation levels. Documentation-Only Deprecations can land in a
543-
minor release. They can not change to a Runtime Deprecation until the next major
544-
release.
542+
the three Deprecation levels. A deprecation can be added to a release line at
543+
any point while that release line is Current, but not once it has entered the
544+
Active LTS or Maintenance phases. A deprecation added while a major release is
545+
Current counts as a deprecation cycle for that release: the API can change to
546+
the next deprecation level in the following major release. Documentation-Only
547+
Deprecations can land in a minor release. They can not change to a Runtime
548+
Deprecation until the next major release.
545549

546550
No deprecated APIs can change to End-of-Life without going through a Runtime
547-
Deprecation cycle. There is no rule that deprecated code must progress to End-of-Life.
551+
Deprecation cycle. An API that received a Runtime Deprecation while a major
552+
release was Current can be removed (End-of-Life) in the following major
553+
release. There is no rule that deprecated code must progress to End-of-Life.
548554
Documentation-Only and Runtime Deprecations can remain in place for an unlimited
549555
duration.
550556

0 commit comments

Comments
 (0)