2022-06-21

JSDoc形式コメントが嫌い

/** */

これ

まず、 /** で始まってるのにたいして、終わりが */

非対称で美しくない

 

複数行にすると各行に無意味に * から始める必要がある

コメントで不必要に見た目を拘るのはやめてほしい

エディタ自動挿入するから自分で打たなくていいとしてもコピペ時など問題になるだけ

あって嬉しいことなど一つもない

 

さらブロックコメントを使ってるせいでネストできない

コメント内で */ を使う場合問題が出る

また一時的コメントアウトしたいときにこのコメントがあるせいでまとめてコメントアウトできない

 

モダン言語なら /// などシングルライン形式のより優れたものがあるのにどうして採用しないのか

そもそもこの特に優れてもない JavaDoc comment を JS やら TS やら PHP やらがそのまま採用したのが問題

記事への反応(ブックマークコメント)

ログイン ユーザー登録
ようこそ ゲスト さん