今ほぼコードレビュー専になってる私が、リーダブルなコードを書くうえで意識してほしいと考えている順番 - Qiita

はじめに 仕事におけるプログラミングの現場においては「リーダブルコード」を求められることが往々にして多いことでしょう。もちろんアーキテクチャやデザインパターン、流行りの機能、書き方を学ぶことで解決することもありますが、「なんか使ってるんだけどわかりづらいな・・・」と思うことがあったりしませんか？ 読みづらいメカニズム まず読みやすくなるためのテクニックを語る前に、「何故読みづらいのか」を考えてみました。 こう思い返してみると、アーキテクチャやデザインパターンやらに依るところはなかったと言っても過言ではなかったかなと思います。 1. そもそもの処理の認識が誤っている 一見読んだだけで理解できないコードがあったときに、書いた方に「これはどういう処理ですか？」と聞きます。そうすると一定のケースで「説明される内容(日本語)がそもそも正しくない」に分類されることが多いのです。 そうしたときには、その