-
Notifications
You must be signed in to change notification settings - Fork 337
Disambiguate attribute deprecation #582
Copy link
Copy link
Closed
Description
There are currently two ways to deprecate at attribute:
- By setting stability to deprecated
- id: status_code brief: 'Deprecated, use `http.response.status_code` instead.' stability: deprecated ....
- By providing
deprecated: descriptionproperty- id: status_code deprecated: "use `http.response.status_code` instead."
The first approach is problematic: once attribute is deprecated it's no longer possible to know what was the stability at deprecation time.
It's problematic for code generation:
- I want to separate experimental and stable attributes into different artifacts (or packages) based on stability level - I no longer know where to put deprecated ones (where they used to be)
- I want to drop deprecated attributes that were experimental at deprecation time and only keep ones that were stable at deprecation time - I'm not able to do it.
Related to #551
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
No labels