私はhttp://www.phpdoc.org/を見ていますが、皆さんが何を役に立ったと思っているのでしょう。私たちのコードを文書化するのに役立つものだけでなく、サイトで頻繁に実行される手順とタスクも必要です。Linux/PHP/MySQL 環境でこれに最適なソリューションは何ですか?
3 に答える
1
PHPDoc がその方法です。
あなたが持っているでしょう：
- 自己生成のドキュメント ファイル。
- それをサポートするエディターのコンテキスト関数ドキュメント (それらの多く);
- ドキュメントが最新かどうかを確認する簡単な方法 (関数/メソッドを使用するたびに docblock が表示されます。通常、DOCS フォルダーは忘却の運命にあります。プロジェクトに取り組んでいない場合にのみ、それらを見るだけです。しばらくの間、その時点でそれらはほとんど自動的に廃止されます);
- とにかくdocblocksを使用すると思うので、別のdocsフォルダーを維持する必要があることはあまり意味がありません。
于 2011-07-13T19:00:15.613 に答える
0
バージョン管理下にある DOCS フォルダー。ダッシュボードのアーカイブには、写真が役立ちます。
于 2011-07-13T18:42:50.320 に答える
0
phpdoc は、コードを文書化するためだけのものです。アーキテクチャを文書化するためのものではありません。そのためにUMLを使用できます。
于 2011-07-13T19:04:22.110 に答える