When graduating an experimental API (<https://kotl...
# announcements
r
When graduating an experimental API (https://kotlinlang.org/docs/reference/experimental.html#graduation-of-experimental-api), does the deprecation level matter? ie would it cause issues for consumers (other than requiring them to update immediately) if the level was set to
HIDDEN
instead of the default
WARNING
? (I’d love to ask this in a more specific channel, but not sure what a good one would be)
k
It would be very confusing to go to hidden immediately, you'll get compiler errors like "unresolved reference" instead of "this is deprecated" etc. Already compiled code will still work but trying to update will be a nightmare. Go for warning or error first.
💯 1
r
I’m talking specifically about deprecating an experimental annotation, though. In that case the migration path is pretty obvious (remove the annotation), and the IDE and build output will still show the deprecation message as part of the error so you can show an error like “@MyAnnotation is no longer required”