You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
I'm thinking the criteria should be based on tags that either:
Have useful information that we wouldn't want to lose (e.g. @returns), or
Might cause the comment to be parsed incorrectly if we simply trimmed the tag (e.g. we can safely omit @constructor, but if we omit @throws then what will we do with {InvalidArgumentException} after it?)
IIRC the compiler team approached their implementation empirically, by amassing a large corpus of TypeScript code from GitHub and then analyzing which patterns were most popular. @DanielRosenwasser do you guys have a list of commonly used JSDoc constructs somewhere?
As the strict mode is defined, what things are important to handle in "Lax" mode?
@tags
@return
instead of@returns
@typeparam
instead of@param
(I haven't seen this but TypeDoc supports it)The text was updated successfully, but these errors were encountered: