And yet, the documentation must be written
this post was submitted on 17 Nov 2024
475 points (98.0% liked)
Microblog Memes
5793 readers
2660 users here now
A place to share screenshots of Microblog posts, whether from Mastodon, tumblr, ~~Twitter~~ X, KBin, Threads or elsewhere.
Created as an evolution of White People Twitter and other tweet-capture subreddits.
Rules:
- Please put at least one word relevant to the post in the post title.
- Be nice.
- No advertising, brand promotion or guerilla marketing.
- Posters are encouraged to link to the toot or tweet etc in the description of posts.
Related communities:
founded 1 year ago
MODERATORS
There's this one guy in the office who were so adamantly anti writing documentation, he basically pored through the contract to find loopholes to state that doing documentation is not actually part of his job description.
This guy either believes his code is god level (and has a huge ego), or just a crappy coder who can't explain what he wrote.
You forgot the most probable option the documentation they want is dog shit. Internal documents are almost universally garbage that is out of date and doesn't cover the important decisions, it just reiterates what is obvious from reading the code.
The consequence of that is if you do read it you effectively have superpowers over the non-readers.
Also people always only answer one question. Don't ask two things at once. This is so infuriating.
Yep.
I have a habit of sending out a list of questions, even when I number it, and only get a basic response to 1-2 questions.
Writing is a passive system for conveying information. It requires active effort by the target. If the target does not want to engage with the information, there is nothing forcing them to unless you add additional systems external to the information.
This is why I follow every single text or email with a, "Hey, did you just see my message?" phone call.
Signs and stuff I can kind of understand. Our world is chock full of things (ads) that try to get our attention at any point. At some point you develop an internal adblock and since 98% is irrelevant it is a reasonable drawback that the remaining 2% gets filtered out as well.
Perfectly fair point. But in business you're supposed to read emails to know what you're supposed to do. But no one does. (too many emails)
Menus have the descriptions of what you want to eat but no one reads them (too vain to wear glasses?)
Forget the creative writing work you've been doing. I mean. Y'know. That's a given.
Sign, Sign, Everywhere a sign, Blocking out the scenery, Breaking my mind
But in business you’re supposed to read emails to know what you’re supposed to do.
So often I get a set of instructions that's missing information, out of date, or deliberately misleading.
I'm often on the line with support walking through the steps and saying "How did you get from D to E?" and then finding out there's a second secret set of instructions only tech support has - possibly even a different website or application - that they don't want to tell you about unless you're talking to an agent for some reason.
Menus have the descriptions of what you want to eat but no one reads them
Sometimes. Often they do not. They also regularly use shorthand or code.
My favorite is a series of red chili peppers next to a menu item. If I order the 1 pepper meal, am I going to be shitting blood for a weak? If I order the 5 pepper meal, are you going to White Guy Spicy it for the table because not everyone looks like they can handle it? It's anyone's guess. If I don't explicitly see the words "peanut" or "shellfish", am I confident it won't have allergens?
Why even have a waiter if you're not allowed to ask these questions, anyway? Just make everything a vending machine.
Exactly this. Imagine the gall of people to complain I don't interact more with their ads. Pricks.
Ah yes.
Also: instead of googling for the opening times better waste everyone's time by sending a text or an email to the shop and making them spell it out for you!
Also: if you see the shop is clearly closed, lights aren't on and you can see the opening times on the door and they say it's not open but someone is inside better start knocking because surely they wish to serve you.
Also: never read the instructions of a product. Instead complain that it's broken and demand a new product. Repeat.
Also: if you see a price list/menu/price tag or similar and you accidentally read it, better double check the price by asking "does this item cost what it says here"
Also: "employees only" actually means "for adventurous customers"
Also: if it says push, pull, if it says pull, push.
sending a text or an email to the shop and making them spell it out for you!
That’s because the shops know that no-one reads the website and doesn’t bother to update the opening hours when they change.
When I worked retail, people would always call asking about hours, especially around holidays. I started answering the phone "[Name of Store], we're open until 9."
The amount of people that didn't process this because they were too focused on what they were about to ask was amazing. The best were the people that realized right after they asked , and you could hear the hamster fall of the wheel.
Not only do people not read, they don't listen either.
This is the PTSD of working with customers talking.
Many of us recognize it well.
Also: if it says push, pull, if it says pull, push.
If there is a handle I pull, if there is a plate I push.
I hate combo plate/handles
Also a big fan of
if you see a price list/menu/price tag or similar and you accidentally read it, better double check the price by asking “does this item cost what it says here”
Because it happens when management has three different prices and five confusing "discount" offers scattered in line of sight. Is this 50% off or does that happen at the register or does it no longer apply? And you've got the same thing on the menu as a side and a meal, which one am I ordering, again?
And
“employees only” actually means “for adventurous customers”
Oh, bathroom for employees only? At every location inside three city blocks? I guess I should just take a crap on the floor.
I always mix up push and pull. They sound too similar to me and the time it takes me to think what I'm supposed to do, I'm already applying force in the wrong direction (or I conclude that push means to apply force towards me, because I end up mixing them up).
A significant fraction of America is illiterate. 21% or 1/5. Yeah.
It's even worse than that:
21% of adults in the US are illiterate in 2024. 54% of adults have a literacy below a 6th-grade level (20% are below 5th-grade level).
So 1/5 can't read at all, and over HALF can't read better than an 11 year old.
Which is wild.
I need to write to a 3rd grade level, and don't think it is possible.
How does that work out, are there 50% of 11 yo in the USA?
:-) Jk
Nooooooo! IT's because the DeMoCrAts didn't address the needs of the working pooooooor! nooooooooooo!
I mean, you think this is happening exclusively in red states?
DC is bright blue and they've got some of the worst schools in the country. And if you want to know why...
Michelle Rhee’s Reign of Error
Privatization, downsizing, teaching to the test... Twenty years of NCLB has taken its toll.
Even then, there is something of a silver lining
The advent of modern text communications has created significant social incentives for improving literacy at younger ages.
If reading is the only driver to voting preference, then yes.
Otherwise, no.
If reading is the only driver to voting preference
Reading is a powerful tool because writing/publishing has a very low barrier to entry.
By contrast, audio and video tend to carry incrementally higher cost for production/distribution.
But you do still need peer groups with good politics to send you in the right direction. You can't expect good politics to emerge ex nihilio across an entire population.
Anyone curious, I fact checked this and according to snopes it's true. This is just sad.
I have always had the opposite problem. You put written words in front of me, and I am compelled to read them. I only stopped reading TOS/EULAs because they're always the same! You read 10 of em, you start to see they're all exactly the same, with just names being changed.
What's the tl;dr for most TOS?
You agree to not break the law using their product, you agree to arbitration instead of going to a real court (which the company would pay for, not you, so please actually take them up on this en mass), you agree to not reverse engineer the code, reproduce the code or redistribute the code, etc. Long ass lists of what you can and can not use it for. Sometimes there's funny shit in there like the tos for iTunes disallows you to use the software to create nuclear weapons. Idk how you would use iTunes for that but I guess they wanted all their bases covered.
Tl;Dr - "You agree to be raped in the asshole by capitalism."
load more comments
(2 replies)
load more comments
(1 replies)
I dont wanna say the average person is stupid but they make it really difficult to not think so.
Call it illiterate tunnel vision or whatever else youd like, but come one.
Heres some personal examples from work:
- big neonsign at the door at eyeheight telling people when the store opens, 1 out of 6 people looks at it the rest doesnt even see it, one once was even mad and blew out the doorglass with a kick.
- registers, big neon signs to say "hey douchenozzle, next one this is closed) and even when another worker is waiting and lookin at the person, they still dont get until you loudly talk to them to come to the other one.
- god forbid someone needs something in another part of the store, unless you use children level semantics (go to blue line for example) they never find what they looking for.
those are just my personal examples but outside of that you see it seemingly everywhere.
big neonsign at the door at eyeheight telling people when the store opens, 1 out of 6 people looks at it the rest doesnt even see it, one once was even mad and blew out the doorglass with a kick.
This sounds like real-world banner blindness. Almost all neon signs are ads or usless bling-bling to catch your attention. It’s no wonder people don’t look at them anymore.
when i say neonsign, i meant the distinct color of the store as a border and than black on white text
banner or not, they still missing it
Well, did you actually read at least the first paragraph of the Wikipedia article I linked?
they are still missing it
registers, big neon signs to say "hey douchenozzle, next one this is closed)
This is just bad design. Almost comically, your sign shouts, “Look at me, there’s nothing to see here”. You’re drawing attention away from where people should go. Of course this isn’t going to work.
Whoever thought advertising a closed register was a good idea needs to have their idea generator checked.
its not literally a neon sign, when i say neonsign i meant its a very distinct color (and clearly different form an ad) with a very visible font
but even if it wasnt there, it would not make any difference, the 1st register could be broken into thousand pieces and people would still try to use it
-
Is it next to the 30 big neon signs advertising 4% off expired yoghurt? I must've missed it while I was looking at literally anything else.
-
Is that sign next to the other shitty advertisements trying to get me to buy an overpriced candy bar before I'm out the door? Sucks, I'm not reading any of them. Deal with it.
-
Your store is literally designed to make people get lost and lose track of time. You're welcome to go fuck yourself and take your annoyance out on your corporate overlords instead of the regular people just trying to find the onions.
im not in america, our stores arent filled to the brim with neon signs
we have exactly one when we have a big sale and the ones at the register, nothing else
our stores are designed for things to be easily found
I worked gate security at a baseball stadium. Right next to where I stood there were two huge signs reading "No Smoking" and "No Re-entry". Guess what questions I got asked all day.
load more comments
(2 replies)
Weird, I read anything my eyes set upon without even thinking about it. Why wouldn't you, unless you're illiterate?
I could not believe that this is not a normal experience. If you put a poster in front of me, the words just get beamed into my brain the moment I'm see it.
But having chatted with people, there was a lot of folks who literally have to switch their brain to reading mode to actually start reading.
In my previous job i had to do a lot of coordination via email. I learned very quickly you can only ask a single question per email because very very few people would ever answer more than that. God forbid there was some semi complex task that needs done.
load more comments
(1 replies)
load more comments
(3 replies)
view more: next ›