git404hub

what is unmaintainable-code fr?

droogans/unmaintainable-code — explained in plain English

Analysis updated 2026-06-24

10,159Audience · developerComplexity · 1/5Setup · easy

tl;dr

A satirical essay by Roedy Green presenting hundreds of deliberately bad programming habits as tongue-in-cheek career advice, widely shared among developers as a checklist of what not to do.

vibe map

mindmap
  root((unmaintainable-code))
    Topics
      Naming tricks
      Formatting tricks
      Structural tricks
      Comment abuse
    Languages
      Java
      C
      General concepts
    Audience
      Working developers
      New developers
    Purpose
      Humor
      Anti-pattern guide

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Read the essay as a checklist of bad coding habits to actively avoid in your own work.

VIBE 2

Share it with new developers as a humorous introduction to why code readability and naming conventions matter.

VIBE 3

Use specific examples from the essay to spot anti-patterns during code review sessions.

how it stacks up fr

droogans/unmaintainable-codesparksuite/simplemde-markdown-editorraulmur/orb_slam2
Stars10,15910,16010,156
LanguageJavaScriptC++
Setup difficultyeasyeasyhard
Complexity1/52/55/5
Audiencedeveloperdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min
Permission given for reproduction, no formal license stated.

in plain english

This repository contains a long satirical essay originally written by Roedy Green, a Canadian software developer. The title is "How To Write Unmaintainable Code," and the joke is that it presents genuinely bad programming habits as if they were career advice. The idea: if you write code only you can understand, your employer will never be able to fire you. The text then walks through hundreds of ways to make code needlessly confusing, all written in a dry, deadpan tone. This is not software you install or run. It is a document, reproduced here in Markdown format so it is easier to read and share than the original webpage. There is no license to speak of, and the author gave permission for this reproduction. The content covers naming strategies (single-letter variable names, deliberate misspellings, using baby name books as a source), formatting tricks (random capitalization, mixing human languages inside variable names, using accented characters that look like regular letters), and structural choices (hiding logic in places nobody would think to look, reusing names in confusing ways, burying important code in comments or in dead-looking branches). The essay spans Java, C, and general programming concepts, though most of the jokes translate across languages. The actual audience is working programmers who will recognize the bad habits described and find them funny. Some readers treat it as a checklist of things not to do. Others share it with new developers as a lighthearted introduction to why code readability matters. It has been circulating in programming communities for decades and has accumulated substantial star count purely from word-of-mouth. If you are a non-technical person, the main takeaway is that this is a joke document about how programmers can accidentally or deliberately make their work impossible for anyone else to understand. The full README is longer than what was shown.

prompts (copy fr)

prompt 1
Based on the unmaintainable-code essay, what are the top 5 naming tricks that make code hardest to maintain, and how do I spot them in a real codebase?
prompt 2
The unmaintainable-code essay lists structural tricks for hiding logic. Give me 3 concrete refactoring examples that would make such code readable again.
prompt 3
I am onboarding a junior developer. Write a 5-minute talk using examples from the unmaintainable-code essay to explain why variable naming and code structure matter.

Frequently asked questions

what is unmaintainable-code fr?

A satirical essay by Roedy Green presenting hundreds of deliberately bad programming habits as tongue-in-cheek career advice, widely shared among developers as a checklist of what not to do.

What license does unmaintainable-code use?

Permission given for reproduction, no formal license stated.

How hard is unmaintainable-code to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is unmaintainable-code for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.