Jamesj999 Lemmy
  • Communities
  • Create Post
  • heart
    Support Lemmy
  • search
    Search
  • Login
  • Sign Up
tetris11@lemmy.ml to Asklemmy@lemmy.ml · 4 个月前

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

lemmy.ml

message-square
36
fedilink
138

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

lemmy.ml

tetris11@lemmy.ml to Asklemmy@lemmy.ml · 4 个月前
message-square
36
fedilink
alert-triangle
You must log in or register to comment.
  • ClassifiedPancake@discuss.tchncs.de
    link
    fedilink
    arrow-up
    54
    ·
    4 个月前

    I always loved this one from my fridge:

    • Zythox@lemmy.dbzer0.com
      link
      fedilink
      arrow-up
      20
      ·
      4 个月前

      What the hell is that supposed to mean?

      • ClassifiedPancake@discuss.tchncs.de
        link
        fedilink
        arrow-up
        44
        ·
        4 个月前

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

        • SeekPie@lemm.ee
          link
          fedilink
          arrow-up
          13
          ·
          4 个月前

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

      • driving_crooner@lemmy.eco.br
        link
        fedilink
        arrow-up
        20
        arrow-down
        1
        ·
        edit-2
        4 个月前

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

  • TXL@sopuli.xyz
    link
    fedilink
    arrow-up
    33
    ·
    4 个月前

    “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
      link
      fedilink
      arrow-up
      16
      ·
      4 个月前

      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!

    • PatheticGroundThing@beehaw.org
      link
      fedilink
      arrow-up
      3
      ·
      4 个月前

      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.

  • CileTheSane@lemmy.ca
    link
    fedilink
    arrow-up
    21
    ·
    4 个月前

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

    • tetris11@lemmy.mlOP
      link
      fedilink
      arrow-up
      5
      ·
      4 个月前

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

      • SkaveRat@discuss.tchncs.de
        link
        fedilink
        arrow-up
        14
        ·
        4 个月前

        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
          link
          fedilink
          arrow-up
          16
          ·
          4 个月前

          RIP SkaveRat

          • SkaveRat@discuss.tchncs.de
            link
            fedilink
            arrow-up
            10
            ·
            4 个月前

            Hasn’t gotten me yet. I should be fi

            • tetris11@lemmy.mlOP
              link
              fedilink
              arrow-up
              1
              ·
              4 个月前

              Oh, hello Fi!

          • Jimmycrackcrack@lemmy.ml
            link
            fedilink
            arrow-up
            5
            ·
            4 个月前

            RIP slaveRat’s computer/phone

        • tetris11@lemmy.mlOP
          link
          fedilink
          arrow-up
          6
          ·
          4 个月前

          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
            link
            fedilink
            arrow-up
            5
            ·
            4 个月前

            Yup

  • Elaine Cortez@lemm.ee
    link
    fedilink
    English
    arrow-up
    17
    ·
    4 个月前

    The Wii safety documentation

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

    • Pacrat173@lemmy.ml
      cake
      link
      fedilink
      arrow-up
      5
      ·
      4 个月前

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

  • zzx@lemmy.world
    link
    fedilink
    arrow-up
    9
    ·
    4 个月前

    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
      link
      fedilink
      arrow-up
      3
      ·
      4 个月前

      I like the old amd ones.

      • TXL@sopuli.xyz
        link
        fedilink
        arrow-up
        1
        ·
        4 个月前

        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.

  • SocialMediaRefugee@lemmy.ml
    link
    fedilink
    arrow-up
    7
    ·
    4 个月前

    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.

    • PatheticGroundThing@beehaw.org
      link
      fedilink
      arrow-up
      8
      ·
      4 个月前

      I always include examples of the actual commands

      You’re an angel.

  • Akasazh@feddit.nl
    link
    fedilink
    arrow-up
    7
    ·
    4 个月前

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

  • Jeena@piefed.jeena.net
    link
    fedilink
    English
    arrow-up
    7
    ·
    4 个月前

    Automotive SPICE ® v4
    Process Reference Model
    Process Assessment Model

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

  • SoftestSapphic@lemmy.world
    link
    fedilink
    arrow-up
    9
    arrow-down
    3
    ·
    4 个月前

    Is this loss?

    • tetris11@lemmy.mlOP
      link
      fedilink
      arrow-up
      8
      ·
      edit-2
      4 个月前

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

  • edric@lemm.ee
    link
    fedilink
    English
    arrow-up
    6
    ·
    4 个月前

    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
    link
    fedilink
    English
    arrow-up
    5
    ·
    edit-2
    4 个月前

    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.

    • Mac@federation.red
      link
      fedilink
      English
      arrow-up
      4
      ·
      4 个月前

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

  • huf [he/him]@hexbear.net
    link
    fedilink
    English
    arrow-up
    5
    ·
    4 个月前

    you must wait for your children or you will accumulate zombies

    unexpected parenting advice in a UNIX programming textbook…

    • tetris11@lemmy.mlOP
      link
      fedilink
      arrow-up
      2
      ·
      4 个月前

      well it’s better then forking them

  • Nomecks@lemmy.ca
    link
    fedilink
    arrow-up
    4
    ·
    edit-2
    4 个月前

    Ghost ride ya whip, a flowchart:

    • tetris11@lemmy.mlOP
      link
      fedilink
      arrow-up
      2
      ·
      4 个月前

      🌈 Now we know! 💯

  • lnxtx (xe/xem/xyr)@feddit.nl
    link
    fedilink
    English
    arrow-up
    4
    ·
    4 个月前

    Aviation procedures manuals.

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

Asklemmy@lemmy.ml

asklemmy@lemmy.ml

Subscribe from Remote Instance

Create a post
You are not logged in. However you can subscribe from another Fediverse account, for example Lemmy or Mastodon. To do this, paste the following into the search field of your instance: !asklemmy@lemmy.ml

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?

  • !lemmy_support@lemmy.ml
  • !fediverse@lemmy.ml
  • !selfhosted@lemmy.world

Looking for a community?

  • Lemmyverse: community search
  • sub.rehab: maps old subreddits to fediverse options, marks official as such
  • !lemmy411@lemmy.ca: a community for finding communities

Icon by @Double_A@discuss.tchncs.de

Visibility: Public
globe

This community can be federated to other instances and be posted/commented in by their users.

  • 980 users / day
  • 2.64K users / week
  • 6.56K users / month
  • 19.2K users / 6 months
  • 1 local subscriber
  • 48.3K subscribers
  • 6.91K Posts
  • 360K Comments
  • Modlog
  • mods:
  • Evan@lemmy.ml
  • mekhos@lemmy.ml
  • tmpod@lemmy.pt
  • OrangeSlice@lemmy.ml
  • Pro@programming.dev
  • BE: 0.19.9
  • Modlog
  • Instances
  • Docs
  • Code
  • join-lemmy.org