<分区>
我以前从不太关心记录我的代码,但最近我开始从事一个开源项目并且需要出现。显然,“首选武器”是 PHPDoc,但是......
我真的找不到 PHPDoc 标准的单一规范。有一个维基百科条目列出了一些属性,还有 phpDocumentor 项目,据说它有一个更广泛的字典,但令我困惑的是 PHPDoc 的权威指南在哪里?是否有一个单一的标准,或者由所有那些众多的 phpDocumentor 仿制品来扩展 PHPDoc“标准”(如果有的话)到它们看起来合适的任何东西。
如果我们假设 phpDocumentor 是创建和维护 PHPDoc 标准的地方,那么事情看起来相当严峻,因为 the project's website现在已经死了将近 4 年了。更让我困惑的是大约一个月前的一个版本 1.4.4在 phpDocumentor 的 Pear 网站上突然死而复生。
我知道这里有很多更聪明、知识渊博的人,所以我想知道。与 PHPDoc 有什么关系。是否有制定标准的单一机构?它有多可靠?有没有 future ,或者我们正在与僵尸打交道,所有的希望都破灭了......
谢谢, 伊沃