Должны ли библиотеки javascript использовать устаревшую аннотацию?

Очевидно, что разработчикам нужно подумать о том, когда отказаться и когда удалять, но мне интересно, как предупредить разработчиков о том, что функция javascript устарела?

Большинство языков (Java, С#, Python) поддерживает устаревшую оценку уровня языка в той или иной форме.

Однако для Javascript я не могу найти стандартного способа, которым разработчики могут указать, что функция устарела (в коде). Лучшее, что я могу сделать, это следовать (большому числу) заметок о выпуске.

В качестве примера, grepping полного источника jQuery 1.8 показывает минимальные встроенные комментарии:

# curl http://code.jquery.com/jquery-1.8.0.js | grep -i depre
// jQuery.support.boxModel DEPRECATED in 1.8 since we don't support Quirks Mode
// *** attrChange attrName relatedNode srcElement  are not normalized, non-W3C, deprecated, will be removed in 1.8 ***
// Some plugins are using, but it undocumented/deprecated and will be removed.
// Deprecated
// Limit scope pollution from any deprecated API
// Deprecated, use jQuery.browser.webkit instead

W3C и MDN, похоже, не имеют стандартного способа или предоставляют предложения о том, как с этим справиться.

Лучшее, что я нашел, это JSDoc @deprecated.

Кто-нибудь знает, есть ли у javascript аннотацию для устаревания, которую я забыл? Есть ли лучшие или более распространенные способы сделать это?

Ответы

console.log('This function is deprecated.');