你用什么来记录网站程序，基础设施和代码？

Question

我正在看http://www.phpdoc.org/，但想知道你们认为有用。我想要一些能够帮助记录我们的代码的东西，还需要在网站上经常执行的程序和任务。在linux/PHP/MySQL环境中，这是最好的解决方案是什么？

Answer 1

您拥有版本控制下的DOCS文件夹。对于仪表板存档，我发现照片很有用。

Answer 2

PHPDoc是要走的路。

您将有：

• 自我生成的文档文件;
• 支持它的编辑器上的上下文功能文档（其中很多）;
• 一种简单的方法来检查您的文档是否是最新的（每次使用函数/方法时都会看到docblock; DOCS文件夹通常注定会被遗忘 - 如果您没有工作，您只能看到它们在一个项目上一段时间，并在那一点上，他们几乎会自动过时）;
• 由于我猜你会使用docblocks，所以不必为了维护一个单独的docs文件夹而产生大量的意义。

Answer 3

phpdoc仅用于记录代码。它并不是要记录架构。你可以使用UML。