The Ascended State of Code Documentation

Description

A two-panel meme that humorously escalates the concept of code documentation. The format is taken from the video game 'Gunpoint,' showing achievement-like notifications. The first panel says, 'Adding comments to your code so others can understand it,' and labels this achievement as 'Gentleman,' showing a pixelated character in a trench coat. The second panel presents a far more extreme idea: 'Voice record yourself speaking out each line of code explaining what it means,' and labels this as 'Perfect Gentleman,' with a glowing, golden version of the same character. The joke satirizes the debate around code documentation by presenting a ridiculously impractical method as the pinnacle of consideration. For experienced developers, it's a funny take on the spectrum of documentation efforts, from helpful to absurdly over-engineered, and the eternal quest for perfectly clear, maintainable code

Common Tags

CodeComments DeveloperHumor CodingHumor Documentation CommunicationGap

Comments

Anonymous ★ Top Pick I submitted a PR with audio commentary, but it got rejected. The reviewer said my explanation of the regex was just 15 seconds of uninterrupted weeping

Anonymous ★ Top Pick

I submitted a PR with audio commentary, but it got rejected. The reviewer said my explanation of the regex was just 15 seconds of uninterrupted weeping
Anonymous

Real gentleman development: commit the code, the ADR, and a narrated director’s-cut .mp3 - then fail CI if the transcript drifts from git blame
Anonymous

Finally, a documentation strategy that combines the searchability of comments with the clarity of that one architect who explains everything through interpretive dance at standup
Anonymous

Ah yes, voice-recorded code documentation - because nothing says 'maintainable codebase' like a 47-minute audio file explaining why you chose that particular regex pattern at 3 AM. Bonus points if you include the existential crisis you had while debugging the edge cases. Future developers will surely appreciate hunting through your spoken-word album to understand why `getUserData()` actually deletes users on Tuesdays
Anonymous

Audio comments stored in Git LFS: fantastic context until a Sev1, when grep returns a 40‑minute monologue and git blame links to Past Me’s podcast
Anonymous

Voice docs: because future maintainers deserve to hear the regret in your voice behind every unchecked TODO
Anonymous

Tried upgrading comments to a 40‑minute voice-over; PR came back: looks fine, but we can’t grep an MP3 - write an ADR, not a podcast
@pavloalpha 5y

cumment
Deleted Account 5y

real men use codes that belong to 30 years ago without any comment
1. @RiedleroD 5y
  
  real men code in assembly
  
  @sylfn 5y
  
  real men code.
  
  @RiedleroD 5y
  
  real men .
  
  @sylfn 5y
  
  real
  
  @RiedleroD 5y
  
  ̣
  
  @sylfn 5y
  
  That dot outside of text scares me
  
  @ZgGPuo8dZef58K6hxxGVj3Z2 5y
  
  Lol
  
  @RiedleroD 5y
  
  ̣̣̣̣̣̣I can make it brighter somehow look: ̣ vs ̣̣̣̣̣̣̣̣
  
  @RiedleroD 5y
  
  alt-gr+shift+ö on my keyboard, but idk if it's on english keyboards as well
  
  @ZgGPuo8dZef58K6hxxGVj3Z2 5y
  
  People who work at unicode standards are bored af
  
  @ZgGPuo8dZef58K6hxxGVj3Z2 5y
  
  How this works lol
@interfejs 5y

just name your fucking variables properly
@nuntikov 5y

Wtf
@nuntikov 5y

That's actually a good idea
@theodolu 5y

Real men directly program hard drive with a magnet
1. @RiedleroD 5y
  
  Real men just hit the computer until it does what they want
2. @sylfn 5y
  
  real men dont use hard drive, they use ssd
  
  @CoolyFooly 5y
  
  real men don't use persistent storage, they use RAM
  
  @RiedleroD 5y
  
  real men don't use storage at all, they directly insert electron into the CPU pins
  
  @RiedleroD 5y
  
  scrap that, real men calculate everything in their head
  
  @Odinmylord 5y
  
  Writes code Shuts down computer Loses it Leaves *Chad image*
  
  @sylfn 5y
  
  have you ever heard about persistent OSes? ah no they use persistent storage...
  
  @Odinmylord 5y
  
  If you use them you aren't a real man
  
  @theodolu 5y
  
  Pussies use ssd
  
  @NiKryukov 5y
  
  real men use floppy
  
  @Dobreposhka 5y
  
  real men are women
  
  @theodolu 5y
  
  They punch holes in cardboards with their colt
  
  @sylfn 5y
  
  real men use paper and pen

Use J and K for navigation

The Ascended State of Code Documentation

Description

Categories

Common Tags

Comments

More like this

Comment Typos: Embarrassing Before AI, Load-Bearing After AI

Self-Documenting Code Taken to Absurd Extremes with Function Name as Comment

Documentation Motivation Shifts From Humans to AI Agents