使用 phpdoc2 记录 php 文件的指南答案

【问题标题】：Guidelines to document php files with phpdoc2使用 phpdoc2 记录 php 文件的指南
【发布时间】：2013-03-09 22:21:50
【问题描述】：

开始记录我的项目，第一次使用 phpdoc2，我遇到了一些问题。我确实阅读了 phpdoc.org 上的指南。

是否有关于使用 phpdoc2 时要记录哪些内容的指南？我必须记录所有变量还是仅记录某个范围/可见性中的变量。

据我所知，您记录每个：

但即便如此......你使用标签能走多远？

【问题讨论】：

【解决方案1】：

文档应涵盖所有最重要的内容。如果可能，您甚至可以提供示例、外部链接等。我用的是doxygen软件，觉得很不错，这个有这些功能。

php.net 手册非常好。它涵盖了每个函数、类、方法，还包括需求、介绍等。

对我来说，最糟糕的问题是我记录了每一个细节，有时我会说“我厌倦了”，然后停止记录或制作最重要的部分。 “我会记住的”。

一个月或一年后删除太长或多余的东西总是比填补缺失的东西更容易。

找到你的观点。

【讨论】：