向JavaScript函数添加文档的标准方式是什么？

Question

我正在寻找为JavaScript项目生成API文档。 JavaScript有没有类似于Python的文档字符串？

function add(a, b) { 
    /** 
    Returns the sum of `a` and `b`. 
    */ 
    return (a - 0) + (b - 0); 
} 

Answer 1

你见过JSDoc（现已被所取代由JSDoc toolkit）？

Answer 2

JSDoc是一种方法。

/** 
* Adds two numbers. 
*/ 
function add(a, b) { 
    return a+b; 
} 

Answer 3

当我需要它，JSDoc是唯一可用的工具，并且是相当混乱。我们总是得到堆栈溢出，因为他们使用perl和正则表达式来解析源代码。乍一看JSDoc Toolkit如上所述看起来不错，他们现在使用JavaScript。

Answer 4

PDoc是用Ruby编写的Prototype库的联机文档生成器。