Skip to content

Commit ebd9af2

Browse files
authored
Add deprecation process. (#16)
1 parent 503fe7b commit ebd9af2

File tree

1 file changed

+12
-0
lines changed

1 file changed

+12
-0
lines changed

community/language-change-process.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -49,3 +49,15 @@ We expect that between 3-7 days will be given for community feedback in typical
4949

5050
The total time spent from creation of the tracking issue to when a feature is marked "stable" may vary with the complexity of a feature, but we expect that it will typically fall in the 1-3 month range. Even if a small feature might be proposed and implemented in a matter of days, it would need to be given sufficient time in the experimental state for community engagement and feedback before being considered for stabilization.
5151

52+
## Feature Deprecation and Removal
53+
54+
The process for the deprecation and removal of features follows a similar flow to that of feature additions: announce the deprecation, plan for backward compatibility, allow a waiting period for community and OWNER feedback, and then proceed with the removal. This process will be refined as we progress.
55+
56+
In cases where an existing feature of the language (even one that was present from before this process, and that thus has no corresponding proposal) is found to be undesirable, a proposal can be made for deprecation and eventual removal of that feature.
57+
58+
Superficially, proposals for deprecation and removal follow the same overall flow as feature additions. In particular, these proposals must be announced in the same channels, and sufficient time for community review must be given before a deprecation is "stabilized," so that it takes effect.
59+
60+
Compared to purely additive features, deprecation and removal comes with a higher risk of breaking existing Slang codebases. As such, proposals for deprecation are expected to include detailed plans around the timeline for sunsetting a feature that is to be removed, potential impact of the removal on existing codebases, and strategies for migration of code using the feature to suitable alternatives.
61+
62+
The Language Owners are expected to scrutinize proposals for deprecation with great care, and to engage with stakeholders including organizations with large Slang codebases.
63+

0 commit comments

Comments
 (0)