質問: OSSにドキュメントの修正でプルリクを送ったところ拒否されましたが、その返信の内容がわかりませんでした。以下URLとその返信内容です。 **返信内容:** > > We never add phpdocs that do not add anything that is not already part of the method signature. > > > **Google翻訳:** > > メソッドシグネチャの一部ではないものを追加しないphpdocsは追加しません > > > 自分は何がいけなかったのでしょうか。是非ご教示願えればと思います。
回答: 三重否定になっているので、日本語にされたってわかりにくいですが、少し表現を変えると「シグニチャーに既に含まれている情報しか追加して無いようなphpdocsは追加しないよ」って、ことです。 「シグニチャー(メソッド名や引数名、引数型)でわかるような情報をheader docに記述しちゃいけない」と言うheader docの原則(日本のプロジェクトだと守られていないことが多いですが)を守れ、と言う趣旨でしょう。 この投稿は @OOPer さんのコメントなどを元に編集し、コミュニティWikiとして投稿しました。