Support @deprecated jsdoc tag
See original GitHub issueIs your feature request related to a problem? Please describe
In my component’s props TS interface, I can use JSDoc comments to set the description, and can even use the @default
tag to describe the default value 💯
However, nothing happens when I use the @deprecated
tag.
Describe the solution you’d like Some ideas:
- It would be nice if the parent
<tr>
gotrequired
anddeprecated
classesNames e.g.<tr className="required">
&<tr className="deprecated">
so that I can easily apply custom styling to these rows. - For deprecated props, it would be nice if the prop name appeared grayed out, and the word Deprecated appeared in bold below it, followed by any description. e.g.
PropName Deprecated since version 2.0
Describe alternatives you’ve considered
For now I will simply omit deprecated props manually per story via the meta default export’s parameters.
parameters.docs.page.excludeProps = ['my_depricated_prop_name']
Are you able to assist to bring the feature to reality? Perhaps in the future but not at this time.
Additional context https://jsdoc.app/tags-deprecated.html
Issue Analytics
- State:
- Created 3 years ago
- Reactions:1
- Comments:5 (2 by maintainers)
Top Results From Across the Web
Use JSDoc: @deprecated
The @deprecated tag marks a symbol in your code as being deprecated. Examples. You can use the @deprecated tag by itself, or include...
Read more >Playground Example - JSDoc Deprecated - TypeScript
JSDoc Deprecated. In 4.0 the JSDoc tag @deprecated is added to the type system. You can use @deprecated anywhere you can use JSDoc...
Read more >JSDoc @param together with @deprecated - Stack Overflow
The @deprecated tag can be used to document that for example a function as a whole has been deprecated. /** * @deprecated since...
Read more >TSDoc: @deprecated
This block tag communicates that an API item is no longer supported and may be removed in a future release. The @deprecated tag...
Read more >API Extractor: @deprecated
The @deprecated tag indicates that an API item is no longer supported and may be removed in a future ... (This is optional...
Read more >Top Related Medium Post
No results found
Top Related StackOverflow Question
No results found
Troubleshoot Live Code
Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start FreeTop Related Reddit Thread
No results found
Top Related Hackernoon Post
No results found
Top Related Tweet
No results found
Top Related Dev.to Post
No results found
Top Related Hashnode Post
No results found
Top GitHub Comments
Hi, since it seems there is no update on this issue, I would like to tackle it.
Hi, Can i dig into this?