Self explaining method names, fluent interfaces, DSLs, helpful frameworks... We are always looking for ways to make our code more readable. But in our quest, we seem to have forgotten something. The most effective way to make any code more readable. I wish to demonstrate this long lost secret.
According to Webster, evident means ‘clear to the vision or understanding.’ In this talk, Stuart presented specific practices that you can apply to make your code more evident, particularly on larger projects.
It is relatively easy to make toy-sized programs evident, but the exciting aspect of these ideas is their application at scale. He shared insights from his own experience applying these practices on a multi-year product effort undertaken in Clojure.