重複の可能性:
自動 PHP ドキュメント生成?
私は PHP の初心者であり、現在の仕事では非常に速いペースで言語を習得する必要があります。
私はドキュメンテーションにこだわっています。ドキュメントを書くのも好きです。私は、いくつかの言語で認められているドキュメントの構文とツールに精通しています。
これは PHP には当てはまりません。
文書化可能なソース コード コメントを記述する方法は常に複数あり、通常は言語ごとにさまざまなツールがあることを私は知っています。ただし、私は、標準的なコメント方法や標準の PHP autodoc ツールを義務付けていない環境にいます。これにより、選択の自由が与えられ、それに伴い、分析による麻痺が少し発生します。
phpDocumentor ( http://www.phpdoc.org/ ) は、PHP autodocs の許容可能な標準ツールですか?
PHP コードを文書化するときに、コードに関する一般的な JavaDoc ガイドラインに従うことは許容されますか?