駆け出しのITエンジニアがやりがちな失敗。先輩から「自分の書いたコードでも1年経てば他人のコード。だからコメントはしっかり書いてね」と指導されるも…

51
えび@プログラマー @ebiebi_pg

ITエンジニア1年目 先輩「自分の書いたコードでも1年経てば他人のコード。だからコメントはしっかり書いてね」 🦐(お前の自論だろ?上から押し付けるな「綺麗に書けばソース読めるやつならちゃんと解るだろが!読めないヤツ乙」) ITエンジニア2年目 🦐(ゴメンナサイ、ゴメンナサイ、ゴメンナサイ)

2022-11-07 23:44:59
えび@プログラマー @ebiebi_pg

エンジニア1年目でモリモリとスキルが伸びて きちんとソース書けるようになったころに 「コメント書け」 なんて言われるとこういうシーンに出会います

2022-11-07 23:45:46

みんなの反応

遊©️ 2022 @4023vqad

@ebiebi_pg コメント書けって言われる環境なのちょっと羨ましい 僕の今の所属、コメント書いてないしコメント書いてプッシュするなとまでいわれる異常な環境なので・・・

2022-11-08 05:47:54
Yamachan @twowho

@ebiebi_pg 昔、COBOLやってたころは、詳細設計書・プログラム設計書どおりにコードを書くってルールだったので、 コメントはほとんど書かなかったですね。

2022-11-08 07:50:07
炊きあがれ!機動炊飯器ガン略 @shino65536

@ebiebi_pg コメントが実装と食い違ってると殺意を覚えるよね。 /** ユーザを登録する */ public function delete(User $user) {...}

2022-11-08 08:47:22
アスランの父 @dad_aslan

@ebiebi_pg コメントやドキュメントは自分も含めた将来、このソースを見た人への手紙だと思っている。

2022-11-08 09:51:32
ゴンノス @g2zZ

@ebiebi_pg 昔の風潮では「コンピュータの進化は早いので 同じプログラムを10年後も使っているなんてないよな」 それなのに現実では 20年前のソース読むはめになったりして。 #なんでこうなった

2022-11-08 09:53:59
人面犬じょり @mekenjyori

@g2zZ @ebiebi_pg 本来なら新ハード規格で互換がない筈が 機器を駆使してデータの移送を行えてしまうから大変な事(管理や様々な面)になってる ポケモンのルビサファがまもなく20年、かがくのちからってすげー 20年前のデータを最新ハードで使えるゲームはオカシイ

2022-11-08 15:51:47
ゆっくりドットコム @ch62547763

@ebiebi_pg ゴメンナサイ、ゴメンナサイ、ゴメンナサイ、ゴメンナサイ、ゴメンナサイ、ゴメンナサイ、ゴメンナサイ、ゴメンナサイ、ゴメンナサイ、ゴメンナサイ、ゴメンナサイ、ゴメンナサイ、ゴメンナサイ、ゴメンナサイ、ゴメンナサイ、ゴメンナサイ、ゴメンナサイ、ゴメンナサイ、ゴメンナサイ、ゴメンナサイ!

2022-11-08 10:04:03
ciro @_ciro_sa

@ebiebi_pg コメント書くのは、特記事項だけで良いと思いますよ。 ※1: ベースのコードが変数名、メソッド名などで説明できてる場合のみ ※2: 説明できてるコードを書ける人は一握り

2022-11-08 10:57:18
daigoro.tsv @daigoro021

@ebiebi_pg 意味不明なコードは、処理の内容がわかっても意図が通じない場合がほとんどです(難読化されたコードもありますが)。 コメントはあくまで「実装者がこのコードを書いた意図」を示すべきな気がします。

2022-11-08 11:49:12
わなごなwannagonna🧲 @TDlMfYJgeZCKao3

@ebiebi_pg 自慢か?3日の時点で他人のコードになる俺は記憶力悪いと言いたいんか!

2022-11-08 12:41:07
th0x0472 @th0x0472

@ebiebi_pg 作業手順書なんかも近いものがありそうですねぇ。 私は「その業務を離れて半年か1年たって業務固有のことをすっかり忘れた自分」でも問題なく作業できる、を目標に手順書を書いてます。

2022-11-08 13:36:44
しろつつじー@プログラムの話題なら極力一緒に悩み〼 @white_azalea

@ebiebi_pg 長く保守されて来たコードだと、メソッド名以上の処理が行われている事もしばしば… リファクタさせてもらえるならまだしも、NGされたらコメントだけが最後の砦になる…。

2022-11-08 18:30:22
molaris @molarisun

@ebiebi_pg うん十年前からソースコードにコメント書いたことがない。困ったことはあんまりない。エレガントすぎるコードは書かないし。一回切りしか使わないプログラムのときしか。

2022-11-08 20:17:10
kumapress @kumapress1

@ebiebi_pg 正しいコメントはお金になりましたし。。 今はどうなんだろ??

2022-11-08 20:34:03
蒼眼鏡👓 @yt93c

@ebiebi_pg ゴードン・アルジャーノン効果っちゅうて、「はあー?なんでこんなコード書けたんや?→昔の俺」って自分のソースコードを見ながら思うことがありますんや。

2022-11-09 00:18:30
ブラックジャックなエンジニア @TOkyaku

@ebiebi_pg 若い時代は、自分で書いたコードはいつまでも忘れずに理解できるかもしれないが歳をとるにつれて段々と忘れてくるようになる。必然的にコメントを自ら書くようになる。コメントのやたら多いコードは歳とったエンジニアかもしれない。

2022-11-09 09:05:34
Instance@VRChat / 原神 @Instance_Main

@ebiebi_pg 「何をしたいか」「そのために何をするか」「このパーツは何か」「このパーツは何に繋がるか」「何故この処理なのか」を書かないと概ね死ぬ

2022-11-08 20:14:35