

OSSにドキュメントの修正でプルリクを送ったところ拒否されましたが、その返信の内容がわかりませんでした。以下URLとその返信内容です。

<https://github.com/symfony/symfony/pull/35730>

**返信内容:**

> We never add phpdocs that do not add anything that is not already part of
> the method signature.

**Google翻訳:**

> メソッドシグネチャの一部ではないものを追加しないphpdocsは追加しません

自分は何がいけなかったのでしょうか。是非ご教示願えればと思います。


CC BY-SA 4.0
2020-02-16T00:45:54.897
63078
2021-03-07T06:38:52.853
2021-03-07T06:38:52.853
3060
37850
question
php 英語 oss symfony
英文の意味を正しく理解できません


三重否定になっているので、日本語にされたってわかりにくいですが、少し表現を変えると「シグニチャーに既に含まれている情報しか追加して無いようなphpdocsは追加しないよ」って、ことです。

「シグニチャー(メソッド名や引数名、引数型)でわかるような情報をheader docに記述しちゃいけない」と言うheader
docの原則(日本のプロジェクトだと守られていないことが多いですが)を守れ、と言う趣旨でしょう。

* * *

この投稿は @OOPer
さんの[コメント](https://ja.stackoverflow.com/questions/63078/#comment69073_63078)などを元に編集し、[コミュニティWiki](https://ja.meta.stackoverflow.com/q/1583)として投稿しました。


CC BY-SA 4.0
2021-03-07T06:17:31.850
74481
2021-03-07T06:17:31.850
9820
63078
answer