This is really a key takeaway here: Always keep your audience in mind. When programming, you have two audiences: the machine executing the code, and fellow programmers maintaining the code. Both are important, but the latter is often neglected and is what the article is about. Optimize for your human audience. What will make it easier for the next person to understand this? Do that.
Like public speaking or writing an article. A great talk or a article happen when the speaker/author knew exactly how the audience would perceive them.
I was thinking of something else in my original comment however; teaching someone to make music is easy, but teaching them to make _great_ music is almost impossible, because the bottleneck to quality art is always one’s “taste” — or “ear” as it’s often referred to by musicians. I think this concept is synonymous with “talent”, a somewhat mysterious phenomenon.
These ideas seem to run parallel to those explored in this thread related to programmers with and without “taste” as it pertains to the quality of one’s code.