Deprecation rules

---

§ Deprecation rules in the Avoid Framework

---

Here are the rules:

1. Stable elements should use the annotation @NeverRemoval.
   Type presence doesn't always indicate all-member presence.

2. Incubating elements should use the annotation @Discouraged.
   This means they're not yet fully established; incompatible changes may emerge.

3. Alpha elements should use the annotation @ApiStatus.Experimental.
   This means they will probably stay, but they're still in development.

4. Deprecated elements should use the annotation @Deprecated.
   This means they shouldn't be used anymore.

5. Internal elements should use the annotation @ApiStatus.Internal.
   This means there's a high chance they might stop being available or get completely refactored, at any time.

Unfortunately however I don't always keep the promise. I do my best to not disappoint you, but sometimes that stupid @NeverRemoval element preventing further progress just has to be wiped out of existence.

Unannotated elements are a middle-ground between @Discouraged and @ApiStatus.Experimental.

Don't hesitate to use cool-looking APIs, though.
If an API looks good and you don't see any implementation/concept errors, then you're most likely fine.