SAP / openui5

OpenUI5 lets you build enterprise-ready web applications, responsive to all devices, running on almost any browser of your choice.
http://openui5.org
Apache License 2.0
2.92k stars 1.23k forks source link

Additional example for @deprecated #3999

Closed OlMue closed 4 months ago

OlMue commented 4 months ago

As discussed with @margopolo and the UA colleagues: In case of deprecations, either the user needs information about whether there is an alternative to the deprecated element, or it needs to be indicated that the concept has been discarded. This PR adds an additional example for the latter. I also removed the part about "internal releases" since this isn't really a common thing anymore and thus doesn't need to be part of these guidelines.

margopolo commented 4 months ago

The correct reference is that the user needs information about whether there is an alternative to the deprecated element, or it needs to be indicated that the API was deprecated without replacement (e.g. because the concept has been discarded).