JSDoc中doclet的正确定义及两类注释示例判定咨询

doclet是JSDoc工具对符合规范的注释块完成解析后，生成的用于描述代码实体（函数、类、变量等）的独立元数据单元，也是生成最终接口文档的核心信息载体。你给出的两个示例对应的注释块，都可以被解析为合法的doclet，二者的区别仅在于适用场景和信息收集逻辑不同：

• 示例1的注释块依附于实际存在的函数代码，JSDoc解析时会自动从下方的myFunction函数代码中提取函数名、参数列表等基础信息，再结合注释里的描述、@param、@returns注解补全doclet的全部信息，不需要额外用注解指定实体类型和名称。这是最常用的doclet写法，适用于常规的、可被JSDoc自动识别的静态代码。
• 示例2的注释块没有关联实际的可执行代码，所以需要通过@function myFunction注解手动指定该doclet对应的实体类型和名称，其余注解的信息会直接填充到这个手动声明的doclet中，解析后同样可以正常在生成的文档里展示。这种写法多用于描述动态生成的、JSDoc无法自动识别的代码实体，或者用来补充第三方依赖的文档信息。

两种注释写法都是合法的doclet输入源，不存在哪一种才是标准doclet的区别，doclet本身指的是解析后得到的结构化元数据，而非特指某一种写法的注释块。

内容的提问来源于stack exchange，提问作者Jackezo Opiklam