Aarón García Hervás

> Quick note: the text are usually stored in a translation files even if we do not support translation yet. I'm assuming we'll need to duplicate the deprecated message in...

Thanks for the input @alexfauquette. I'll go ahead and separate this PR into two: 1. Allow JSDoc tags in components and hooks JSDoc comments. 2. Automate displaying deprecation messages in...

@siriwatknp some notes: - I tried to mark `ListItemSecondaryAction` as `@deprecated` using JSDoc but it was picked up as the component description in the docs. Is there a way to...

> Should we remove ListItemSecondaryAction from the list of APIs in the [Lists docs page](https://mui.com/material-ui/react-list/#api)? We have a specific rule to validate that every public component is included in at...

I think we should look into being able to mark components as `@deprecated` in JSDoc without it ending up in the component docs description so we can: - Automatically display...

I opened a draft PR with a potential approach we could use to treat JSDoc comments as the source of truth for deprecations: https://github.com/mui/material-ui/pull/42280

~A visual regression test is [failing](https://app.argos-ci.com/mui/material-ui/builds/27937/90283991) but it's unrelated and it's also failing in other PRs e.g. https://github.com/mui/material-ui/pull/42236~ edit: this is resolved now

@mnajdova I'll do it 👍

Docs improvements up for review https://github.com/mui/material-ui/pull/42239

@fonty422 I'm not able to reproduce the issue locally following the steps you provided i.e. the DOM node count doesn't increase every time the menu is opened. Can you provide...