// v1.0.0 (finally deployed)
Everyone sends exactly what they mean.
No one receives exactly that.
We're a little website devoted to the art of miscommunication: the gaps, the gaps within the gaps, and the "as discussed" that was discussed by no one, with no one, about nothing.
* No messages were harmed in the making of this website. Some were merely misunderstood.
$ cat CHANGELOG.md --truthy
What release notes actually mean
Every changelog is a love letter to the future, written in a language the past can't read. Here's the translation, from our linguists.
"Improved performance"
It was slow. Now it's less slow. The baseline has been quietly retired.
"Enhanced user experience"
The button moved. You will find it. Eventually. Probably on the left.
"Minor bug fixes"
Fixed one bug, introduced three, and gave two of them names we can't say in changelogs.
"Deprecated support for X"
X still works. Mostly. We stopped apologising for it.
"This release requires upgrading all dependencies"
Good luck. We wish it well from a distance.
"Now with AI!"
There is a small box that does the thing. The box is 90% confident.
"Known issues: none"
Known: 14. Issues: 14. None: yes, we've been meaning to fix them.
"Breaking changes" (in a v0.x release)
Breaking: yes. Changes: it's a different product now. v0.x was never a promise, we just said it fast.
## meetings: where language goes to die
The meeting that could've been an email
A 45-minute conversation about what a "quick sync" means. Field notes.
"Let's just circle back on this." (a loop begins, no point of origin)
"Can we take this offline?" (the topic will be discussed in another meeting)
"Do we need everyone in this room?" (yes, but only the three people who left)
"Right, so action item: Sarah will 'drive this'." (a verb with no noun attached)
"Thanks all, great discussion." (nobody agrees, but nobody left either)
A second meeting is scheduled to discuss the outcome of the first.
in-reply-to: (nothing)
Emails, annotated
The tone of a sentence is a coin flip. The reply-all button is a coin flip with witnesses.
From: You
"Just a quick question: when you get a chance, could you give me a rough ETA?"
translation: I am already stressed. The question is load-bearing.
From: Dev
"Depends."
translation: a complete and accurate answer, in one word.
From: You
"As per my last email..."
translation: read the other 47 emails. Or don't. Same energy.
From: Dev
"Sent from my iPhone" (the message, incidentally, was not)
translation: authority, delivered via a device. Discretion, optional.
lookup --lang business_english
A small dictionary
Selected entries. Pronunciations approximated. Meanings guaranteed.
- "low-hanging fruit"
- The easy tasks we do first, so that when the hard ones arrive, we have a story to tell.
- "let's not reinvent the wheel"
- Let's use the wheel someone else built. It wobbles, but at least the invoice isn't ours.
- "it's not working"
- An entire incident report. Details to follow, if you're quick, and if prod is still up.
- "works on my machine"
- A peer-reviewed result, single reviewer, no reproducibility data, published in a journal nobody subscribes to.
- "this is a culture problem"
- The bug is real, the timeline is fictional, and both are now everyone's problem.
- "sorry for the delay"
- There was no delay. The delay is the email.