this post was submitted on 04 Feb 2025
126 points (100.0% liked)

Asklemmy

44697 readers
983 users here now

A loosely moderated place to ask open-ended questions

Search asklemmy ๐Ÿ”

If your post meets the following criteria, it's welcome here!

  1. Open-ended question
  2. Not offensive: at this point, we do not have the bandwidth to moderate overtly political discussions. Assume best intent and be excellent to each other.
  3. Not regarding using or support for Lemmy: context, see the list of support communities and tools for finding communities below
  4. Not ad nauseam inducing: please make sure it is a question that would be new to most members
  5. An actual topic of discussion

Looking for support?

Looking for a community?

~Icon~ ~by~ ~@Double_A@discuss.tchncs.de~

founded 5 years ago
MODERATORS
 
top 34 comments
sorted by: hot top controversial new old
[โ€“] huf@hexbear.net 3 points 31 minutes ago

you must wait for your children or you will accumulate zombies

unexpected parenting advice in a UNIX programming textbook...

[โ€“] fmstrat@lemmy.nowsci.com 2 points 1 hour ago* (last edited 1 hour ago) (1 children)

The Voron 3D Printer assembly manual. It's like IKEA and OSI had a baby.

https://raw.githubusercontent.com/VoronDesign/Voron-0/Voron0.2r1/Manuals/VORON_V0.2r1_Assembly_Manual.pdf

I'm going to do a write-up on this in the future. It really is a wonderful experience.

[โ€“] macgyver@federation.red 1 points 6 minutes ago

My Voron made me want to pull out my hair going through the instruction manual. Absolutely hated building it.

[โ€“] ClassifiedPancake@discuss.tchncs.de 45 points 20 hours ago (1 children)

I always loved this one from my fridge:

[โ€“] Hellstormy@lemmy.dbzer0.com 17 points 20 hours ago (2 children)

What the hell is that supposed to mean?

[โ€“] ClassifiedPancake@discuss.tchncs.de 39 points 20 hours ago (1 children)

It means if the fridge makes those sounds there is nothing to worry about.

[โ€“] SeekPie@lemm.ee 9 points 4 hours ago

And it doesn't have to be printed out in different languages.

[โ€“] driving_crooner@lemmy.eco.br 17 points 20 hours ago* (last edited 19 hours ago)

When you call costumer service, instead of going "it's making this sound SRRR! SRRR!" you can say it's making the fly noise

[โ€“] Nomecks@lemmy.ca 3 points 13 hours ago* (last edited 13 hours ago) (1 children)

Ghost ride ya whip, a flowchart:

[โ€“] tetris11@lemmy.ml 1 points 4 hours ago

๐ŸŒˆ Now we know! ๐Ÿ’ฏ

[โ€“] CileTheSane@lemmy.ca 16 points 19 hours ago (1 children)
[โ€“] tetris11@lemmy.ml 4 points 18 hours ago (1 children)

I love that. So he only likes pictures? If you write text, he will still take you?

[โ€“] SkaveRat@discuss.tchncs.de 8 points 17 hours ago (2 children)

Any written or spoken information about 2521 will cause it to grab it. Be it whatever is used to write it down, or whoever said it.

So it can only be described in images, photos or pictograms

[โ€“] CileTheSane@lemmy.ca 11 points 17 hours ago (2 children)
[โ€“] Jimmycrackcrack@lemmy.ml 5 points 13 hours ago

RIP slaveRat's computer/phone

[โ€“] SkaveRat@discuss.tchncs.de 8 points 16 hours ago

Hasn't gotten me yet. I should be fi

[โ€“] tetris11@lemmy.ml 5 points 16 hours ago (1 children)

Ah so the guy in Scenario A actually writes a piece of text which the SCP consumes. If he drew an image, nothing would happen?

[โ€“] Corno@lemm.ee 17 points 23 hours ago (1 children)

The Wii safety documentation

and here I was, wanting to go skydiving with a Wii...

[โ€“] Pacrat173@lemmy.ml 5 points 22 hours ago

I was hoping someone would post this one itโ€™s a classic

[โ€“] XTL@sopuli.xyz 29 points 1 day ago (2 children)

"Do not dangle the mouse by the cord or throw at co-workers."

"All parts of the computer should fit together easily and without force. By all means, do not use a hammer!"

But seriously, some old UNIX workstation and server manuals come to mind as there's no mention of Microsoft anywhere. Just a good description of how the computer is actually supposed to be used.

Also home computer manuals and some hifi and lab equipment manuals which came with full schematics and measurement and calibration procedures. They essentially gave all users the maintenance manual and not just the dumb user one.

dumb user one

Really pisses me off

Last router I had to install had a manual that was literally only "Put this cable in this hole. Click this button. Et voila." with no explanation what any of the other buttons or slots or indicators were for.

[โ€“] Crazyslinkz@lemmy.world 17 points 1 day ago

Also home computer manuals and some hifi and lab equipment manuals which came with full schematics and measurement and calibration procedures. They essentially gave all users the maintenance manual and not just the dumb user one.

I wish this was more of a thing. Right to repair!

[โ€“] zzx@lemmy.world 8 points 21 hours ago (1 children)

Any of the classic RFCs. I really like the way RFCs are written.

Also, they're extremely verbose, but the Intel x86 processor manuals are fascinating

[โ€“] gens@programming.dev 3 points 19 hours ago (1 children)
[โ€“] XTL@sopuli.xyz 1 points 5 hours ago

I think datasheets for components are often pretty great. At least the old ones with good application information and all that.

Then again, for a modern MCU or something there's several books worth of information, so it won't be on one document any more.

[โ€“] Akasazh@feddit.nl 6 points 21 hours ago

I loved when games came with manuals. FI Sid Meiers Pirates

[โ€“] SocialMediaRefugee@lemmy.ml 7 points 22 hours ago (1 children)

I like writing documentation for processes at work. I always aim it at the "I'm familiar with the tools but haven't done this before" person. I always include examples of the actual commands because it is one thing to describe a command but when you see it it makes FAR more sense.

I always include examples of the actual commands

You're an angel.

[โ€“] SoftestSapphic@lemmy.world 6 points 22 hours ago (1 children)
[โ€“] tetris11@lemmy.ml 8 points 21 hours ago* (last edited 21 hours ago)

Lmao, didn't notice that but I can actually see it

[โ€“] scytale@lemm.ee 6 points 23 hours ago

Like the picture in the post, furniture assembly. I enjoy assembling simple furniture (couches, chairs, storage, etc.) and trying to figure out the documentation, especially if it's made in china with inaccurate instructions, missing or unlisted parts, and the entire thing not in english.

[โ€“] jeena@piefed.jeena.net 7 points 1 day ago

Automotive SPICE ยฎ v4
Process Reference Model
Process Assessment Model

https://vda-qmc.de/wp-content/uploads/2023/12/Automotive-SPICE-PAM-v40.pdf

[โ€“] lnxtx@feddit.nl 4 points 23 hours ago

Aviation procedures manuals.

You more remember documentation which sucks than a good examples.
Sometimes is better to just read a source code.