>>787
君が言いたい事はわかるが、とうの昔に多言語で実装されている。

・MS系(VB/C/C#)のドキュメントコメント
・Java系のjavadoc
・ECMAScript(JS/AS/etc)のコメント

phpdocはそれに倣っただけだ。
あとアノテーションについて学べ。まずはそこからだ。

＞重要なのは、コードを変更した時、同じ事を二度やらなければいけないということ。
IDEが自動で変えてくれる。

＞コードとドキュメントの整合性が取れなくなるのは、これが理由。
整合性がとれなくなるのは、開発者が無知だからであって、言語のせいでは無いよ。

＞長文になる時は別の書き方を用意すればいいだけの話。
長いコメントと短いコメントの記載場所が2箇所に別れちゃうんだｗ
で、長いコメント書く場合の改行やパラメータの区切りはどうすんの？ @param とか明示的な文法が必要じゃね？