“良いコード”を書くとはどういう意味ですか？ [クローズ]

私にとっては…別のプロジェクトに取り組んでいる同僚がやって来て、各ブロックを通過することなく自分が何をしているかを理解できるようになったときに、私は良いコードを書いていることを知っています。
彼が「ちょっと待って、何？！」と言う代わりに。彼は、「ああ、わかりました。そこで何をしたかわかります」と言っています。

優れたコードには、卑劣な回避策や「ハック」もあまりありません。あなたが「それを書いている間、あなた」があなた自身にも「これはそれをするのに良い方法ではないことを知っていますが、私は」今のところこの方法でそれをしなければならないでしょう。 「後で改善するように自分に言い聞かせます…」

「優れた」コードには多くの機能があります、しかし最も重要なIMHOは、読みやすさと保守性です。

コードにはバグが含まれ、おそらく拡張されて再利用され、 ある時点でリファクタリングする必要があります。再訪したとしても、そもそも何をしたのかわからない可能性があります。

確かに、その複雑でありながら非常に効率的なアルゴリズムを使用しますが、それを文書化するために少し余分な時間を費やすことを確認してください。コードは明確で一貫性があります。