• Ephera@lemmy.ml
    link
    fedilink
    English
    arrow-up
    3
    ·
    3 months ago

    Which is why making code readable is so very important. Our juniors and students will think we’re ridiculous, when we spend a long time cleaning up some code or choosing the least misunderstandable name for a type. But you fuck that up and then others, as well as your future self, will be wasting many more minutes misunderstanding what your code does.

    • rockerface 🇺🇦@lemm.ee
      link
      fedilink
      arrow-up
      1
      ·
      3 months ago

      I treat my future self a few months from now as a separate person who does not remember anything about why or what the specific code fragments do. And I’m grateful to my past self for doing the same.

      Plus, you never know when you need to actually delegate supporting a particular piece of a solution to another person.

  • Beanie@programming.dev
    link
    fedilink
    arrow-up
    1
    ·
    3 months ago

    It’s thing! Omni-man says ‘thing’, not ‘part’. I’ve seen this meme format for a few years now and I’ve only just realised it’s a misquote after watching the show. Completely irrelevant nitpick I know but some people might appreciate it.

  • wise_pancake@lemmy.ca
    link
    fedilink
    arrow-up
    1
    ·
    3 months ago

    The people who say “the code is the documentation” totally misunderstood what that was supposed to look like

  • fubarx@lemmy.world
    link
    fedilink
    arrow-up
    1
    ·
    edit-2
    3 months ago

    My first tech job out of college, I was told to go talk to “Dave,” the guru old-timey programmer and learn the lay of the land. He turned out to be this crotchety old guy, with low tolerance for idiots, but a soft spot for someone who actually paid attention.

    A few months in, I was told to go fix a feature in the company’s main product which was sold to power utilities. This was a MASSIVE code base, with a mix of C, C++, assembler, and a bit of Fortran thrown in. I spent a week poring through all the code trying to figure things out. Then I hit a mystery workflow that didn’t make sense.

    I walk over to Dave’s office and ask a specific question. Now, mind you, he had worked on this years ago, and had long moved on to new products. He leans back in his chair, stares at the ceiling, then without looking at the screen once tells me to go look at such and such file for such and such variable, and a list of functions that were related. I go back to my desk and damn if it wasn’t EXACTLY as he described.

    Now, I’m probably as old as he was then. I don’t remember what I wrote an hour ago. No matter what I build, I’ll always be in awe of Dave and what he could keep in his head.

  • some_guy@lemmy.sdf.org
    link
    fedilink
    arrow-up
    1
    ·
    3 months ago

    This made me chortle. I remember when I first joined a dev team asking someone how many of something their section should be able to store:

    I don’t know, I’d have to look at the code.

    It was an eye opening moment. Very few people can keep everything in their head. I’ve met a couple. They were rockstars who were truly exceptional.

    • cbazero@programming.dev
      link
      fedilink
      arrow-up
      0
      arrow-down
      1
      ·
      3 months ago

      You dont. Thats why you write code that explains itself. For higher level info you write documentation.

  • bitwolf@sh.itjust.works
    link
    fedilink
    English
    arrow-up
    0
    ·
    3 months ago

    Partially yes. But if I create something myself I can “revisit” the headspace of that portion very easily, like I walked into a room.

    Doesn’t work as well on codebases I don’t own fully though.

    • Ephera@lemmy.ml
      link
      fedilink
      English
      arrow-up
      0
      ·
      3 months ago

      Yeah, which is why pairing works so well. Suddenly, you’ve got two people who were there when it was created and might know why certain design decisions were made.