I agree with the sentiment that gratuitous happy-talk adds noise to what ought to be clear, bottom-line-up-front engineering communications. But the recipients of those communications are people, and most people have feelings. So a good engineer ought to optimize those communications for
overall success, and that means treating the intended recipients as if they matter. Some human-level communication is usually beneficial.
So, to use an example from the original post:
> "I hope this is okay to bring up and sorry for the long message, I just wanted to flag that I've been looking at the latency numbers and I'm not totally sure but it seems like there might be an issue with the caching layer?
There’s a lot of noise in this message. It’s noise because it doesn’t communicate useful engineering information, nor does it show you actually care about the recipients.
Here’s the original post’s suggested rewrite:
> The caching layer is causing a 400ms overhead on cold requests. Here's the trace.
This version communicates some of the essential engineering information, but it loses the important information about uncertainty in the diagnosis. It also lacks any useful human-to-human information.
I’d suggest something like this:
> Heads up: It looks like the caching layer is causing a 400ms overhead on cold requests. Here's the trace. Let me know how I can help. Thanks!
My changes are in italics. Breaking them down:
“Heads up” provides engineering context and human-to-human information: You are trying to help the recipients by alerting them to something they care about.
“It looks like” concisely signals that you have a good faith belief in your diagnosis but are not certain.
“Let me know how I can help” makes clear that you share the recipients’ interest in solving the problem and are not just dumping it at their feet and turning your back on them. You and they are on the same team.
“Thanks!” shows your sincere appreciation to the recipients for looking into the issue. It’s a tiny contribution of emotional fuel from you to them to give them a boost after receiving what might be disappointing news.
In sum, strip the noise and concisely communicate what is important, both engineering information and human information.