by mmoustafa on 6/7/24, 7:53 PM with 128 comments
by powersnail on 6/7/24, 10:47 PM
Instead, it's the typical kind of mistake made by writers who forget about context.
From the programmer's perspective, I speculate, the error _is_ indeed a case of something being non-existent. The code is written to fetch something from the server, the server says it's not there, and well, the application should tell the user about it.
Within the very narrow context of fetching it from the server, "doesn't exist" is correct. However, in the context of the user who's sitting there looking at the message, "doesn't exist" is simply false.
The message needs to be re-contextualized, such that it makes sense. "The message doesn't exist on the server, it exists on your computer at the moment, but just for a short while, so you better copy it".
It doesn't matter whether the user understand what a "server" is. Simply knowing that the message doesn't exist [at some place], is enough to make the whole sentence sensible.
Like if I go to a car mechanic, who just points to the whole car and say "it's gonna be replaced", it would be confusing. But if he says that "xxx is gonna be replaced", that's perfectly comprehensible, even if I don't know what xxx is.
by ajkjk on 6/7/24, 10:18 PM
by jiggawatts on 6/7/24, 10:35 PM
Every other storage-related system I’ve ever used either had inscrutable gibberish like:
“Mode 5/7?” [Y]
Or overly dumbed down questions like: Are you sure? [N]
What am I sure about!? What is mode 5? Or is it 7? Both? What!? [1]Norton meanwhile had several paragraphs of text explaining what every decision meant. It explained concepts inline. It provided an explanation of the benefits and risks. It let you make an informed choice instead of just hitting Y over and over and hoping for the best.
This kind of respect for the reader / user applies to all forms of technical writing such as manuals, user interfaces, blog articles, and API docs.
Instead of trying to dumb down the text for a “lay” audience, try to educate all audiences to become more technical after having read and understood what you wrote.
[1] That is verbatim from a Hitachi SAN array that was holding all of the data for a government department. The manual helpfully explained that this option toggles between mode 5/7 being either on or off. If you choose wrong the array will erase itself and kill your cat. Or neither of those things. Who knows?
by scarmig on 6/7/24, 9:53 PM
None of that is to say that I agree with the goal of engagement over conveying information.
by nicbou on 6/8/24, 7:37 AM
People are not stupid, but they are busy, tired, lazy, or simply not that interested in the finer details. There is a balance between respecting their intellect and respecting their time.
by photochemsyn on 6/8/24, 1:12 AM
> Q: "Do you like the idea that our picture of the world has to be based on a calculation which involves probability?"
> A: "...if I get right down to it, I don't say I like it and I don't say I don't like it. I got very highly trained over the years to be a scientist and there's a certain way you have to look at things. When I give a talk I simplify a little bit, I cheat a little bit to make it sound like I don't like it. What I mean is it's peculiar. But I never think, this is what I like and this is what I don't like, I think this is what it is and this is what it isn't. And whether I like it or I don't like it is really irrelevant and believe it or not I have extracted it out of my mind. I do not even ask myself whether I like it or I don't like it because it's a complete irrelevance."
As far as complexity and how to explain things to people without technical experience of the subject, the rabbit hole always goes deeper. Here's a nice quote from the rotation in space section of the caltech lectures:
> "We shall not use these equations in all their generality and study all their consequences, because this would take many years, and we must soon turn to other subjects. In an introductory course we can present only the fundamental laws and apply them to a very few situations of special interest."
by lisper on 6/8/24, 1:24 AM
Cool! Someone noticed me!
:-)
(I find this noteworthy because I've been putting all this effort into writing a series of blog posts about the scientific method and I've gotten very little feedback on that. But this little throwaway comment, that gets attention! Life is funny sometimes.)
by protomolecule on 6/8/24, 6:43 AM
by neontomo on 6/8/24, 12:40 AM
I feel the example given in the article is bad because it isn't useful to either person, and jargon doesn't improve or lessen it. It's simply a poor explanation, which makes the argument weak.
by Vt71fcAqt7 on 6/7/24, 10:38 PM
Maybe it should be even less descriptive.
"This message will soon no longer be available. Make sure you copy the contents of the message before you discard if you want to use them later."
Talking about the cache doesn't help the user. Really the solution is to add a button at the end of the message that says "save message contents to device." Then the message is clear and easily actionable.
by bluenose69 on 6/8/24, 8:49 AM
A driver does not need to know the reason for a detour. All that matters is whether the alternative route is clearly indicated.
by wszrfcbhujnikm on 6/8/24, 9:16 AM
by nostrebored on 6/7/24, 10:06 PM
What’s the point of conveying root causes to the user? In this case the error tells you what you need to know: copy the message. Send it again if you want.
The point of communication isn’t always education. This isn’t a razor. It doesn’t do anything to help you consider audience. It will lead you to bad conclusions.
by mannykannot on 6/8/24, 2:29 PM
[1] https://news.ycombinator.com/item?id=40607307
[2] https://profmattstrassler.com/2024/04/16/why-the-higgs-field...
by hifrote on 6/7/24, 9:54 PM
I think things like Feynman’s “little arrows” descriptions in QED only muddied and added to the mystique and mysticism of the physics he loved.
Which is interesting because his written lectures[1], though, in their breadth and complexity require effort, seem as if they are intended for experts while being approachable to ”the layperson“.
My only real complaint about those lectures is that even when I understood I rarely felt I had actionable tools for that new knowledge.
The best descriptions of physics I feel that can sufficiently inform “the layperson” are ones that implements the physics in code[2], or through numerical methods.
by Archelaos on 6/8/24, 4:22 PM
by drewcoo on 6/7/24, 9:41 PM
It's possible to be a great teacher without being an expert on given subject matter. And it's possible to have the most expertise but be inscrutable.
In the case of this quote, Feynman wasn't talking about expertise at all, but about explaining a thing with enough relevant details to be understood. Without those, a layman would not understand either.
by mihaic on 6/8/24, 6:39 AM
Small changes creeping up into something stupid is a common thing as well when everyone just does a tiny isolated part.
by taneq on 6/8/24, 11:12 AM
by satisfice on 6/8/24, 8:58 AM
by cde-v on 6/7/24, 9:33 PM
by MrPatan on 6/8/24, 8:46 AM
by ordu on 6/8/24, 12:11 PM
> "This message has been deleted from the mail server, but Outlook still has it in its temporary cache on this device. You can copy the message contents, or discard it from the cache, at which point it will be permanently deleted."
can be understood. Even if the first sentence looks like a technical garbage, the second gives the clear instructions. And I don't believe that the first sentence is a complete nonsense to a layman. It can be understood as "message is halfway through the process of the deletion".
by amai on 6/8/24, 7:35 PM
The last part of this quote is often forgotten.
by greekanalyst on 6/8/24, 9:27 AM
by sublinear on 6/7/24, 10:55 PM
I don't believe Feynman ever meant to overconstrain and corrupt information based on (likely incorrect) assumptions about his audience. There's no need to "dumb down" anything ever, not even for children.
The information is either there or it isn't regardless of who can comprehend it. Losslessness is non-negotiable. The real problem is how you present that information, not whether you should leave it out. The only time you should leave something out is if it has little to no relation to the rest of what you're trying to say.
> This message has been deleted from the mail server, but Outlook still has it in its temporary cache on this device. You can copy the message contents, or discard it from the cache, at which point it will be permanently deleted.
Oh yeah also let's solve the "puzzle" from the middle of the blog post in Microsoft-y language everyone is familiar with by now.
"This message was deleted due to your organization's retention policy, spam filter, or administrator. It temporarily remains on this device, but is at risk of being lost forever. Do you want to save a copy?"
I believe in the real world Outlook doesn't even bother and has you and your message eat shit. If it was deleted it will never tell you about a cached copy and to the layperson it's just gone. The road to hell is paved with good intentions and indecision only makes communication harder.
by corinn3 on 6/8/24, 5:47 PM
Cache is a variable. Server is a function. Anyone who graduated high school should know that much.
Hopefully we’ll start to move away from 1900s ignorant business machines euphemisms for applied physics
by fragmede on 6/8/24, 8:35 AM