javascript - Sails.js 项目中的嵌入式文档

Question

在 Sails.js 中生成新模型或 Controller 时，它们是通过以下方式创建的:

/**
* Test.js
*
* @description :: TODO: You might write a short summary of how this model works and what it represents here.
* @docs        :: http://sailsjs.org/#!documentation/models
*/

这可能是个愚蠢的问题，但此类声明的预期解析器是什么？是否有生成此文档的内置实用程序？

Answer 1

有点像 JSDoc ，尽管 @docs 标签是非标准的。 Sails 中没有内置实用程序来从模型本身生成这些文档；这只是一条消息，提醒您可能需要记录您的代码:)