Clever vs. Insightful Code
When I advise people to write simpler code I do mean &quot;not clever.&quot; Nor do I mean &quot;insightful.&quot; In fact, please make it so obvious that in reading it I don&#x27;t gain&#x2F;need&#x2F;curse&#x2F;applaud any insights.<p>Make it simple enough that a brand new completely green junior member of the team immediately understands it on first reading.<p>And if you can&#x27;t make the code completely obvious (e.g. the sorting example), just add a comment. A simple one.<p>None of this is about the creator&#x27;s cleverness or deep understanding or speed or what tooling can do. It&#x27;s not about the creator or the machine at all. Simple code is about clarity for all the people who will read and (hopefully not) debug it later.