Improve Metadata JSDoc (#69037)
Currently the JSDoc for deprecated metadata fields is too confusing.
`@deprecated` tag is inside the `@example` and it doesn't give any
information about the deprecation.
This fix adds a deprecation message and a link to the correct docs.
