Skip to content

Commit 4f42b06

Browse files
committed
clarify relationship with deprecated
1 parent 7ce2ecf commit 4f42b06

File tree

1 file changed

+2
-1
lines changed

1 file changed

+2
-1
lines changed

proposals/2020-10-28-Experimental.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -113,12 +113,13 @@ This kind of requirement is handled for TypeScript libraries by [api-extractor](
113113
### Unanswered Questions
114114
115115
- If an operation is not marked as experimental, but it is using a schema which is (i.e. as its request object), then it is implicitly also unstable. Would this usage be considered invalid?
116-
- Should `experimental` and `deprecated` be mutually exclusive?
117116
118117
## Backwards compatibility
119118
120119
The `experimental` field would default to false, meaning existing behaviour is preserved, and the new field is only used on an opt-in basis.
121120

121+
`experimental` can coexist with `deprecated` - an operation, parameter or schema can be both experimental and deprecated, having never gotten to a stable point before being deprecated.
122+
122123
## Alternatives considered
123124

124125
- _Specification extensions_ - publishers could add an extension in their own domain, but the benefit of the metadata being available to downstream tools (including those used by consumers, not just publishers) would be lost.

0 commit comments

Comments
 (0)