标准变更评论

Tor*_*rez 1 php standards comments

我正在寻找一些标准格式的方向来评论PHP的变化.在与大量项目的各种开发人员合作时,评论不断发表,并且在大多数情况下,评论的评论很差或根本没有评论.

这是一个例子,请随意扩展它:

/**
 * Author: [first and last name]
 * Date Changed: [YYYY-MM-DD]
 * Description: [description]
 */

问:有没有人知道评论PHP变化的标准化方法?

Iva*_*uev 7

这些事情不应该放在文件评论中.使用修订控制软件来存储文件的所有版本(不仅仅是最新版本).永远不要让开发人员没有它.此类软件允许您使用源代码执行更多操作:

  • 您可以找到谁更改了文件的每一行
  • 您可以将文件还原为以前(或工作)版本
  • 您可以创建源的不同分支并自动合并它们
  • 您可以自动构建软件并自动运行测试
  • 备份您的源存储库,您永远不会丢失您的工作
  • ...... 等等