你用什麼來記錄網站程序，基礎設施和代碼？

Question

我正在看http://www.phpdoc.org/，但想知道你們認爲有用。我想要一些能夠幫助記錄我們的代碼的東西，還需要在網站上經常執行的程序和任務。在linux/PHP/MySQL環境中，這是最好的解決方案是什麼？

Answer 1

您擁有版本控制下的DOCS文件夾。對於儀表板存檔，我發現照片很有用。

Answer 2

PHPDoc是要走的路。

您將有：

• 自我生成的文檔文件;
• 支持它的編輯器上的上下文功能文檔（其中很多）;
• 一種簡單的方法來檢查您的文檔是否是最新的（每次使用函數/方法時都會看到docblock; DOCS文件夾通常註定會被遺忘 - 如果您沒有工作，您只能看到它們在一個項目上一段時間，並在那一點上，他們幾乎會自動過時）;
• 由於我猜你會使用docblocks，所以不必爲了維護一個單獨的docs文件夾而產生大量的意義。

Answer 3

phpdoc僅用於記錄代碼。它並不是要記錄架構。你可以使用UML。