• SeekPie
          link
          fedilink
          133 months ago

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

      • @[email protected]
        link
        fedilink
        20
        edit-2
        3 months 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

  • TXL
    link
    fedilink
    333 months ago

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

    • @[email protected]
      link
      fedilink
      173 months 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!

    • @[email protected]
      link
      fedilink
      33 months ago

      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.

  • @[email protected]
    link
    fedilink
    93 months ago

    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

      • TXL
        link
        fedilink
        13 months 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.

  • @[email protected]
    link
    fedilink
    73 months ago

    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.

  • edric
    link
    fedilink
    English
    63 months 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.

  • huf [he/him]
    link
    fedilink
    English
    53 months ago

    you must wait for your children or you will accumulate zombies

    unexpected parenting advice in a UNIX programming textbook…

    • Mac
      link
      fedilink
      English
      53 months ago

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

  • lnxtx (xe/xem/xyr)
    link
    fedilink
    English
    43 months ago

    Aviation procedures manuals.

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