tsdoc icon indicating copy to clipboard operation
tsdoc copied to clipboard

Published 20 hours ago • verified publisher icon microsoft

Deprecate and remove @override

Open Gerrit0 opened this issue 2 years ago • 2 comments

TypeScript 4.3 introduced the override keyword, which appears to have the same semantics as this tag, with the benefit of being directly recognized by the language. As such, for recent TS versions this tag is potential for confusion. It should either be deprecated / removed, or it's documentation updated to clarify why it exists alongside the keyword and when it should be used instead/in addition to the keyword.

Gerrit0 avatar Apr 24 '22 05:04 Gerrit0

The override keyword isn't present in the .d.ts (https://github.com/microsoft/TypeScript/issues/2000#issuecomment-813527475) and API Extractor runs on .d.ts. Playground. This should be mentioned in the documentation at https://tsdoc.org/pages/tags/override/. Thoughts @octogonz?

zelliott avatar May 06 '22 16:05 zelliott

I second @Gerrit0's issue regarding this tag. It should be deprecated. However, is TSDoc handling the native override keyword?

SmashingQuasar avatar Apr 25 '23 13:04 SmashingQuasar