Standard/automated markup for deprecated or removed API functionality

Open dmethvin opened this issue 9 years ago • 1 comments

Right now it's easy to overlook that some API is deprecated or removed, for example the .load() method. Sometimes it's best to add explicit wording, for example jQuery.unique() is replaced by jQuery.uniqueSort(). However it would be nice to have some sort of standard visual for these APIs. Is a modal or inline dialog that can be dismissed/collapsed too intrusive? Perhaps a watermark?

Aug 12 '16 14:08 dmethvin

This is still a pretty common pain point, I looked up jQuery.isWindow and even though it's marked deprecated in the XML I could not tell from the page and almost created another ticket. Also there is no Deprecated 3.3 category.

Should we be adding some text or a warning box to deprecated functions to make it more obvious?

Mar 29 '18 23:03 dmethvin