Microsoft/TypeScript
Ver no GitHubwiki doc: @template reference re: jsdoc (and old usejsdoc.org reference)
Open
#31.885 aberto em 13 de jun. de 2019
DocsHelp Wanted
Métricas do repositório
- Stars
- (48.455 stars)
- Métricas de merge de PR
- (Mesclagem média 6d 17h) (9 fundiu PRs em 30d)
Description
TypeScript Version: N/A
Search Terms: docs, template, wiki
Code
N/A
Expected behavior:
@template is not a recognized tag per https://jsdoc.app/ , even if could be compatible as a custom tag. I think your docs at https://github.com/Microsoft/TypeScript/wiki/JSDoc-support-in-JavaScript should make clear that while the other items in the list of jsdoc tags are standard jsdoc, the particular tag @template is an exception and is not standard jsdoc.
Also, the reference to "usejsdoc.org" should be changed to its new site: jsdoc.app. (See https://github.com/jsdoc/jsdoc/issues/1642 on the lack of a working redirect.)
Actual behavior:
- https://github.com/Microsoft/TypeScript/wiki/JSDoc-support-in-JavaScript seems to imply that
@templateis a valid, standard jsdoc tag or at least doesn't clarify that it is a custom tag and not one with behaviors compatible with jsdoc. - The docs link to usejsdoc.org
Playground Link:
N/A
Related Issues:
None found.
@sandersn