Skip to content

add @legacy tag - #2139

Open
81reap wants to merge 1 commit into
jsdoc:mainfrom
81reap:add-legacy-tag
Open

add @legacy tag#2139
81reap wants to merge 1 commit into
jsdoc:mainfrom
81reap:add-legacy-tag

Conversation

@81reap

@81reap 81reap commented May 6, 2025

Copy link
Copy Markdown
Q A
Bug fix? no
New feature? yes
Breaking change? no
Deprecations? no
Tests added? yes
Fixed issues n/a
License Apache-2.0

The defintion of deprecation is to discourage use of code as it will be removed in future versions. See defition and example #3 for Merriam Webster Dictionary and defition and example #1 in the Oxford Dictionary of English.

However, developers are using the deprecated tag to discorage use of code that will never be removed. A new legacy tag is better supported for use cases like that.

@81reap

81reap commented May 6, 2025

Copy link
Copy Markdown
Author

Missed adding that I grew up writing Java so this is why I have this distinction.

edit :: seems like Java 24 uses forRemoval to provide distinction. I will defer to library maintainers as to what would be a better approach here. I can raise another PR

image

@81reap

81reap commented Sep 23, 2025

Copy link
Copy Markdown
Author

@hegemonic could I get a review/feedback here?

@mehulkar mehulkar mentioned this pull request Dec 17, 2025
@81reap

81reap commented May 12, 2026

Copy link
Copy Markdown
Author

Hello again, almost a year later.
@hegemonic do you have any recommendations on how I should go about getting changes approved and merged? Not sure if there's anything more I'm missing or if there's stuff to be bar raised. Happy to improve the PR until it meets your standards as well

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant