Pricefield | Lemmy
  • Communities
  • Create Post
  • Create Community
  • heart
    Support Lemmy
  • search
    Search
  • Login
  • Sign Up
@[email protected] to Programmer [email protected] • 2 months ago

The general feeling of documentating things

lemmy.world

message-square
54
fedilink
1.08K

The general feeling of documentating things

lemmy.world

@[email protected] to Programmer [email protected] • 2 months ago
message-square
54
fedilink
  • Sibbo
    link
    fedilink
    63•2 months ago

    The documentation:

    Put the leaves inside the cup

    • @[email protected]
      link
      fedilink
      49•2 months ago

      Then the user rips open the bag and pours the leaves inside

      • @[email protected]
        link
        fedilink
        2•2 months ago

        I mean that’s a valid way of tea drinking.

      • @[email protected]
        link
        fedilink
        3•2 months ago

        If a highly improbable spaceship had to dedicate all of its processing power to making a cup of tea, I suppose I can forgive an end user for having to think about it.

        • @[email protected]
          link
          fedilink
          1•2 months ago

          Tea, earl grey.

          • @[email protected]
            link
            fedilink
            1•2 months ago

            But what temperature?!

            FWIW, my reference was to H2G2 and the Heart of Gold.

            • @[email protected]
              link
              fedilink
              2•2 months ago

              H O T .

      • snooggums
        link
        fedilink
        English
        10•2 months ago

        Yes, that could be a third option.

      • @[email protected]
        link
        fedilink
        7•2 months ago

        And pours the boiling water on its legs.

    • @[email protected]
      link
      fedilink
      2•
      edit-2
      2 months ago

      It does say “leaves” and not “bag”

    • @[email protected]
      link
      fedilink
      English
      7•
      edit-2
      2 months ago

      All lot of it is, without exageration, more at the

      Put the proper side inside the cup

      level of clarity: in other words just moving the “everybody should know this” element around rather than concretely just coming out and clarifying the bit that in the programmer’s mind is “obvious”.

      • @[email protected]
        link
        fedilink
        4•
        edit-2
        2 months ago

        If you’re specialised enough it can be really hard to tell what’s obvious. Like, you don’t want to do “grab the mouse, which is one of your computer peripherals” either. Or at least, I worry about doing something like that, and coming across as a dick.

        Relevant XKCD.

      • @[email protected]
        link
        fedilink
        2•2 months ago

        A lot of it is just “put it in”

Programmer [email protected]

[email protected]
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: [email protected]

Welcome to Programmer Humor!

This is a place where you can post jokes, memes, humor, etc. related to programming!

For sharing awful code theres also Programming Horror.

Rules

  • Keep content in english
  • No advertisements
  • Posts must be related to programming or programmer topics
  • 24 users / day
  • 300 users / week
  • 1.29K users / month
  • 4.36K users / 6 months
  • 3 subscribers
  • 1.56K Posts
  • 55.5K Comments
  • Modlog
  • mods:
  • Feyter
  • adr1an
  • @[email protected]
  • Pierre-Yves Lapersonne
  • UI: 0.18.4
  • BE: 0.18.2
  • Modlog
  • Instances
  • Docs
  • Code
  • join-lemmy.org