Docs: JSDoc for method decorators don't render properly

[dreamorosi]

Description of the improvement

Summary of the proposal
Currently hovering on a decorator in VS Code shows an unindented code example with also additional characters (*) around the decorator name. This, aside from the fact that decorators are still experimental in TypeScript, is probably due to either the @ sigil conflicting with JSDocs (which uses the same symbol to delimit sections) and/or VS Code itself.

Discussion of the issue here.

TODO:

• Create isolated code sample
• Test if this is an issue in other IDEs (like the IntelliJ ones)
• Open an issue on the TS or VS Code repos

How, where did you look for information
Hover on a decorator while on VS Code.

Missing or unclear documentation
N/A

Improvement
The code example should be indented & highlighted/rendered properly.

Related existing documentation

Related issues, RFCs

N/A

[dreamorosi]

Opened issue on the VS Code repo: microsoft/TypeScript#47679

[dreamorosi]

Update on the above:

The issue on the TS repo was initially included in the TypeScript 4.7.0 milestone but it has now been rescheduled as part of the 4.8.0 milestone (link).

The milestone is, at the time of writing this, at 2% completion and includes north of 350 issues.