コーディング

ソースコメントも理路整然に

ソースコメントにはWhy notを書くのが良いと言われている。 (ソース意図について5W1Hに関する情報はコミットログから読み取れるため) そんなソースコメントについて、口語体で開発者の実装当時の気持ちが見え隠れするようなコメントを見かけることがある。 .…

「リーダブルコード」の水平展開

もし「リーダブルコード」を弁護士が読んだら? https://tech.mntsq.co.jp/entry/2022/12/27/144435 「一定のインプットを入れると、必ず一定のアウトプットが返ってくるように設計された独自の言語体系」 契約で取り扱われる文書においても、上記のような言…