Update November 2020
一个网站现在已经上线,所有的TSDoc语法都可用(这太棒了):https://tsdoc.org/
For reference, old answer:
The right syntax is now the one used by TSDoc. It will allow you to have your comments understood by Visual Studio Code or other documentation tools.
有关语法的详细概述,请参见第here页和第especially here页.精确规格should be "soon" written up.
另一个值得判断的文件是this one,在那里你会看到有用的标准标签.
Note:你不应该使用JSDoc,正如TSDoc主页:Why can't JSDoc be the standard? Unfortunately, the JSDoc grammar is not rigorously specified but rather inferred from the behavior of a particular implementation. The majority of the standard JSDoc tags are preoccupied with providing type annotations for plain JavaScript, which is an irrelevant concern for a strongly-typed language such as TypeScript. TSDoc addresses these limitations while also tackling a more sophisticated set of goals.所解释的