2
2

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

More than 5 years have passed since last update.

コミュニケーションAdvent Calendar 2015

Day 14

コメントは将来の自分へのメッセージ

Posted at

背景

先日先輩から「お前のコメントで解決って書いてあるんだけど、これどうやってやるの?」という問い合わせがあり、1年前ってこともあり全然思い出せない悲しみを味わった。。。

思ったこと

過去の俺どうやって解決したんだ!!!!!!!!
どうやってもそのconfigファイル書かないと動かないぞ???
過去の俺はどうやってそのconfigファイル書かないで動かしたんだ!!!!!
あん時めんどくさがらずにコメントちゃんと書いておけばよかったorz

今回のことでの教訓

結構前からお前のコメントは簡略化しすぎと指摘を受けていた。
自分でもそれなりにその言葉を理解し長くならない程度でコメントを書いていたつもりだった。
これからはredmineのコメントなどは少なくとも記憶喪失になった自分が将来見てもわかるように書こうと思った。

今回の失敗の原因

解決と書いてあって、解決した理由は過去の自分曰くそのconfigファイルを使わないことだったらしい。
しかし!
そのconfigファイルを使わないでどうやって動かしていたのかが全く書いていない!
過去の俺どうやってこの問題解決したの???
今となっては誰もわからずorz

普段からコメントを書くことについて軽視していた傾向があった。
どうせこのタスク終わったら誰も見ないでしょという油断。。。

今回のことを生かして

これからは以下のことに注意してコメントを書いていこうと思う。

  • 誰と
  • どんなやり取りがあったか
  • 対策
  • やり方

コメントを書くときは将来の自分へ向けて
「お前こんなことやってたぜ!」っていう気持ちで書こうと思う。

2
2
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
2
2

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?