Readability Glossary
Browse 14 readability terms defined in plain English, from the cultural dictionary of computing.
14 Readability Terms
- Code as Literature
- The idea that code should be readable, coherent, and interpretable by humans in a way somewhat analogous to well-written prose. In culture, the phrase often...
- Code Comment
- Non-executable text embedded in source code to explain intent, assumptions, constraints, or tricky behavior to future readers. Good code comments clarify why...
- Lix Score
- A readability metric used to estimate how difficult text is to read, based on sentence length and word complexity.
- Magic Constant
- A hardcoded numeric or literal value whose meaning is unclear from the surrounding code. In engineering slang, magic constants are small but potent signs that...
- Magic Number
- A hardcoded numeric literal in code whose meaning is not obvious. 'if (retries > 7)' — why 7? Name it: MAX_RETRIES = 7. Magic numbers are code smells that make...
- Nesting Hell
- A piece of code with so many nested conditionals, loops, or callbacks that it becomes painful to read and reason about. The phrase points to complexity caused...
- Ninja Code
- Code that is clever, dense, or difficult to follow, often admired for technical trickiness but criticized for poor readability and maintainability. The phrase...
- No Hidden Control Flow
- A language design principle (notably in Zig and Go) where all control flow is explicit and visible in the source code — no hidden function calls from operator...
- One Liner
- A command or piece of code compressed into a single line, usually for speed, cleverness, or convenience. Some one-liners are elegant; others become unreadable...
- Self-Documenting Code
- Code written clearly enough through structure, naming, and small focused logic that its purpose is understandable with minimal explanatory comments. The term...
- Sleight of Code
- Code that achieves an effect through cleverness or indirection that feels a little too magical. In engineering slang, sleight of code may impress people...
- Syntax Sugar
- Syntactic features in a programming language that make code easier to read or write but don't add new capabilities — they're just a sweeter way to express...
- Too Clever
- A judgment that a solution values cleverness over clarity, durability, or maintainability. In engineering slang, code that is too clever usually works right up...
- Type Alias
- A named shorthand for an existing type or type expression, introduced with `type` in TypeScript or `typedef`/`using` in other languages. It does not create a...
Related Topics
- Slang (3 terms in common)
- Code Quality (3 terms in common)
- Writing (2 terms in common)
- Programming (2 terms in common)
- Shell (1 terms in common)
- Code Style (1 terms in common)
- Trickery (1 terms in common)
- Developer Humor (1 terms in common)
- Typescript (1 terms in common)
- Software Culture (1 terms in common)
- Naming (1 terms in common)
- Code Smells (1 terms in common)
- Design Principle (1 terms in common)
- Docs (1 terms in common)
- Anti Pattern (1 terms in common)
- Type Systems (1 terms in common)
- Language Design (1 terms in common)
- Abstraction (1 terms in common)
- Documentation (1 terms in common)
- Overengineering (1 terms in common)