question-mark
Stuck on an issue?

Lightrun Answers was designed to reduce the constant googling that comes with debugging 3rd party libraries. It collects links to all the places you might be looking at while hunting down a tough bug.

And, if you’re still stuck at the end, we’re happy to hop on a call to see how we can help out.

Support @deprecated jsdoc tag

See original GitHub issue

Is 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> got required and deprecated 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:open
  • Created 3 years ago
  • Reactions:1
  • Comments:5 (2 by maintainers)

github_iconTop GitHub Comments

2reactions
yuisato1025commented, Dec 8, 2022

Hi, since it seems there is no update on this issue, I would like to tackle it.

2reactions
siradjicommented, Oct 15, 2020

Hi, Can i dig into this?

Read more comments on GitHub >

github_iconTop 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 >

github_iconTop Related Medium Post

No results found

github_iconTop Related StackOverflow Question

No results found

github_iconTroubleshoot Live Code

Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start Free

github_iconTop Related Reddit Thread

No results found

github_iconTop Related Hackernoon Post

No results found

github_iconTop Related Tweet

No results found

github_iconTop Related Dev.to Post

No results found

github_iconTop Related Hashnode Post

No results found