Sins Of Code Readability

Sin 1 Favoring Cleverness over Clarity.
Sin 1a: Brevity is not clever-ity.
Sin 2: Overly Generic Function Signatures.
Sin 3: Comments Inside Functions.
Sin 3a: Soft Code is a Soft Sin.
Sin 4: Comments Instead of Self-Documentation.
Sin 5: Failing The Squint Test.

http://enemyhideout.com/2022/03/sins-of-code-readability/

#cleancode