强制开发人员在函数中添加注释

Question

我知道这一定是一个简单的问题。但我努力谷歌搜索，但找不到一个合适的结果。我管理着一个大团队，有很多人在我手下工作。我想确保我的开发人员编写的每个函数都应该在它之前有一个注释。在我的 tslint 文件中添加规则是有意义的。

如何强制我的开发人员在函数开始之前添加注释(如下所示(？

/**
* This function returns a string hello
* @author Sahil Purav
*/
myfunction(): string {
   return 'hello';
}

Answer 1

我对此

进行了更多的研究，发现 tslint 中有一条规则来强制执行注释和好事，它是高度可配置的。

我使用了以下规则，足以满足我的要求：

"completed-docs": [
      true,
      {
        "enums": true,
        "functions": {
          "visibilities": ["exported"]
        },
        "methods": {
          "location": "instance",
          "privacies": ["public", "protected"]
        }
      }
    ]

有关更多信息，请查看此 - https://palantir.github.io/tslint/rules/completed-docs/