タグ

ブックマーク / qiita.com/hiro-hori (1)

  • 「コメントは書くな」 - Qiita

    同僚だったロシア人のMはとにかくすごいエンジニアで、給料について社長ともめていたかと思えば、スーパーデプロイシステムを一人で作り上げていたり、Python推しの会社の中で、各所を説き伏せてTypeScript on node.jsの導入を進めたりしていた。 皮肉屋で、だれかれかまわず議論をふっかけていたが、とにかく仕事が速くて品質がよいので絶大に信頼されていた。 私は開発者としてMから様々な教えを授けられた。当時私はPHPerあがりのひよっこで、日々ダメコードを生産していた。 ある日Mにコードレビューを依頼すると、こんなことを言われた。 「堀さん!ソースコードにコメントを書いてはいけない!」 // connect to the database named "mysql" on the localhost val driver = "com.mysql.jdbc.Driver" val u

    「コメントは書くな」 - Qiita
    kiyo_hiko
    kiyo_hiko 2019/07/01
    自分とこは製品の正確さとか歪みとか三角関数だの線形代数だの微積で評価するコードを書いてる。はっきり言ってコメントがないと意味不明になる。TeXでコメント書くだけでもあとからの理解がかなり楽になる
  • 1