Skip to content
DevMeme
3290 of 7590
Self-Explaining Code Or Bust
CodeQuality Post #3614 · source on Telegram

Self-Explaining Code Or Bust

Description

The image is a dark-mode Twitter screenshot from "de va cis" at @dcgmechanics. The tweet reads: "Code is like humor. When you have to explain it, it's bad." The timestamp line says "6:42 PM · 29 Aug 21 · Twitter for Android", with "View Tweet activity" and the usual reply, retweet, like, and share icons below. The technical point is a clean-code aphorism: code should communicate intent clearly enough that later maintainers do not need a forensic lecture to understand it.

Categories

CodeQuality Documentation Communication DeveloperExperience DX

Common Tags

CodeReadability CleanCodePrinciples CodeQuality CodeMaintainability SoftwareBestPractices CodeComments TechnicalCommunicationSkills DeveloperHumor TechTwitter CodingHumor EngineeringWisdom

Comments

6
Anonymous ★ Top Pick If the punchline needs a sequence diagram, the real joke is probably the abstraction boundary.
  1. Anonymous ★ Top Pick

    If the punchline needs a sequence diagram, the real joke is probably the abstraction boundary.

  2. @okutaner 4y

    This humor is about code comments by the way.

  3. @Baksy93 4y

    any oop code is bad for juniors

  4. @nuntikov 4y

    Le problem ensues when your code is a form of humor

    1. @RiedleroD 4y

      push to master *hilarity ensues*

      1. @nuntikov 4y

        😂

More like this

More like this in CodeQuality →
CodeQuality CodeReadability CleanCodePrinciples
The Evaluation Metric Is Reading the Code

The Evaluation Metric Is Reading the Code

AI ML
O(n²) That Works vs O(n log n) Nobody Can Maintain

O(n²) That Works vs O(n log n) Nobody Can Maintain

CS Fundamentals
qrpff: DVD DeCSS Descrambler in 472 Bytes of Perl

qrpff: DVD DeCSS Descrambler in 472 Bytes of Perl

Cryptography
Use J and K for navigation