Open jasonkuhrt opened 3 years ago
Currently something like this:
/** * foo summary * * @custom foo */ export interface B {}
Leads to parsing @custom foo as part of the summary text.
@custom foo
Could there be a mode to treat any line-starting unescaped @<valid_tag_name> as an unknown tag block? It would parse as simply:
@<valid_tag_name>
A use-case for this would be a doc tool listing the unknown tags with relative niceness, e.g.
##### Unknown Tag 1 <content> ##### Unknown Tag 2 <content>
🤔 Given that most TSDoc tags are block tags, maybe by default @custom should be interpreted as a block tag.
@custom
No objections. What would the alternatives be?
Currently something like this:
Leads to parsing
@custom foo
as part of the summary text.Could there be a mode to treat any line-starting unescaped
@<valid_tag_name>
as an unknown tag block? It would parse as simply:A use-case for this would be a doc tool listing the unknown tags with relative niceness, e.g.