FUBAR: Stop Using Acronyms and Put Some Thought Into Names đ„
Stop naming things like youâre naming a military op. Acronyms, branding, and buzzwords make communication harder, not easier. Good naming is part of good developer experience. Put some care into it.
How you do anything is how you do everything. And that includes how you name things.
In software, communication isnât just nice to haveâitâs essential. Every label, name, or term we use becomes part of the developer experience. And too often, we make that experience worse by being careless, cryptic, or too clever for our own good.
Letâs talk about acronyms, bad naming, and buzzwordsâand why theyâre quietly sabotaging your team.
đ« Acronyms Arenât Helping
Theyâre supposed to simplify things. But most of the time, they just make things harder.
- A different language: Acronyms feel like insider speak. New hires, cross-functional teammates, and even your future self will have to pause and decode.
- Not inclusive: If someone has to ask what it means, youâve already created a barrier.
- Pretentious: It can come off like you're trying too hard to sound smartâor worse, important.
- Meaningless over time: The more you use it, the less anyone remembers what it stands for.
- Thereâs usually a better name: Just say what it is.
- Cool for the sake of being cool: If your acronym feels more like a brand than a descriptor, youâre doing marketing, not communicating.
đ€Š Poor Naming is a Long-Term Tax
Every name you pick is a design decision. Treat it like one.
- Words matter: Labels shape how people understand and relate to a thing.
- Youâll regret rushing: It always seems minor⊠until youâre stuck explaining it for the 50th time.
- Donât overthink it, but donât ignore it: No need to spiral, but donât shrug it off either.
- The more important, the more care it deserves: Core services, shared concepts, major featuresâthese names stick. Make them count.
- In code, naming is UX: Good naming makes code readable, teachable, and usable.
One time I translated a system that labeled every interaction as a âdigital retail finance transactionâ into what it really was: a loan. The sighs of relief were audible. Thatâs the power of naming something what it is.
đ Branding and Codenames: Fun but Fragile
Cute names are fine⊠until people have no idea what youâre talking about.
- Fun â Functional: Internal names like âMagical Unicornsâ, "Percolator" or âStorrow Driveâ donât tell you what the thing does.
- Donât leak into code: Keep branded terms in your marketing docs, not your logic files.
- Name it for association: The name should naturally connect to its purpose. Donât force it.
- Great for pitch decks, bad for PR reviews: What sells well doesnât always read well in a pull request.
đŁ Buzzwords Make Things Worse
Buzzwords try to make things sound big and cool. Usually, they just make them vague and bloated.
- Simple things sound complex: âSynergizing omnichannel architectureâ vs. âHooking up the API.â
- Trendy â clear: If youâre aiming for clarity, skip the hype.
- They age fast: Buzzwords go stale quick. Good naming lasts.
- They're red flags: When someone canât explain a project without buzzwords, they might not understand it either.
âš Slangcronyms? Use with Care
Not all shorthand is badâjust know where and when to use it.
- Great for Slack and casual chats: Slangcronyms like FUBAR or YOLO can bring levity and bonding.
- Terrible for docs: If someone needs to reference it later, it shouldnât require translation.
- Sometimes a great icebreaker: Used right, they can set tone and build camaraderieâas long as you're not relying on them to explain the work.
đ§ Final Thought
Naming is part of the job. If you care about the experience of working in your codebase or your team, then you have to care about the language you use.
So donât fall for the trap of sounding cool, clever, or corporate. Be clear. Be honest. Say what the thing is. Give it a name that respects the people whoâll have to use, support, or explain it for years to come.
Because how you name things⊠is how you build things.