クラス用のインラインドキュメントは、Javadocに似たPHPDocの流儀に沿っ ている必要があります。PHPDocに関するより詳細な情報は、 http://www.phpdoc.de/ にあります。
ドキュメント以外のコメントも強く推奨されます。一般的な指針としてあ るコードのブロックを見て、「これを説明したいとは思わない」と思った 場合には、動作内容を忘れる前にコメントを書く必要があります。
C 形式のコメント (/* */) と標準的な C++ のコメント (// ) は共に使 用可能です。Per/シェル形式のコメント (# ) の使用は推奨されません。