Everyone loves reading documentation, what are some of your favourites?

122 points · 32 comments · view on lemmy.world

32 Comments

ClassifiedPancake@discuss.tchncs.de · 50 pts · 1y (4 replies)

I always loved this one from my fridge:

Hellstormy@lemmy.dbzer0.com · 18 pts · 1y (3 replies)

What the hell is that supposed to mean?

ClassifiedPancake@discuss.tchncs.de · 43 pts · 1y (1 reply)

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

SeekPie@lemm.ee · 13 pts · 1y

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

driving_crooner@lemmy.eco.br · 18 pts · 1y

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

XTL@sopuli.xyz · 31 pts · 1y (1 reply)

"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.

Crazyslinkz@lemmy.world · 17 pts · 1y

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!

CileTheSane@lemmy.ca · 18 pts · 1y (8 replies)

This is one of my favorites: https://scp-wiki.wikidot.com/scp-2521

tetris11@lemmy.ml · 3 pts · 1y (7 replies)

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

SkaveRat@discuss.tchncs.de · 12 pts · 1y (6 replies)

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 · 14 pts · 1y (3 replies)

RIP SkaveRat

SkaveRat@discuss.tchncs.de · 9 pts · 1y (1 reply)

Hasn't gotten me yet. I should be fi

tetris11@lemmy.ml · 1 pts · 1y

Oh, hello Fi!

Jimmycrackcrack@lemmy.ml · 5 pts · 1y

RIP slaveRat's computer/phone

tetris11@lemmy.ml · 5 pts · 1y (1 reply)

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?

SkaveRat@discuss.tchncs.de · 4 pts · 1y

Yup

Corno@lemm.ee · 16 pts · 1y (1 reply)

The Wii safety documentation

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

Pacrat173@lemmy.ml · 4 pts · 1y

I was hoping someone would post this one it’s a classic

zzx@lemmy.world · 9 pts · 1y (2 replies)

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 pts · 1y (1 reply)

I like the old amd ones.

XTL@sopuli.xyz · 1 pts · 1y

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.

jeena@piefed.jeena.net · 7 pts · 1y

Automotive SPICE ® v4
Process Reference Model
Process Assessment Model

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

SocialMediaRefugee@lemmy.ml · 7 pts · 1y

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.

Akasazh@feddit.nl · 6 pts · 1y

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

SoftestSapphic@lemmy.world · 6 pts · 1y (1 reply)

Is this loss?

tetris11@lemmy.ml · 8 pts · 1y

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

scytale@lemm.ee · 6 pts · 1y

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.

fmstrat@lemmy.nowsci.com · 4 pts · 1y (1 reply)

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 · 3 pts · 1y

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

lnxtx@feddit.nl · 4 pts · 1y

Aviation procedures manuals.

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

Nomecks@lemmy.ca · 4 pts · 1y (1 reply)

Ghost ride ya whip, a flowchart:

tetris11@lemmy.ml · 2 pts · 1y

🌈 Now we know! 💯