• BearOfaTime@lemm.ee
    link
    fedilink
    English
    arrow-up
    11
    arrow-down
    1
    ·
    9 months ago

    Last time I was laid off it started with “we need to really nail down the docs for these systems”.

    No one ever gives you extra time for documentation.

    Like you, my responsibilities were split between 2 or 3 people.

    I’ll never again do documentation that well. Fuck 'em. That’s not true - I will, for myself.

    • SolarMech@slrpnk.net
      link
      fedilink
      English
      arrow-up
      5
      ·
      9 months ago

      Those are really stupid managers.

      If you don’t have docs it’s a tough competition between having your more knowledgeable devs re-explaining what they know X times to X new hires, or letting new devs figure it out on their own which is both costly in terms of their time and more importantly, risky as hell.

      Bad managers love risk though. Since it usually is a choice between speed now and risk later, it only blows up in your face later, and quite spectacularly, and everyone looks like heroes while they are putting fires out on overtime.

      That said good managers probably don’t tolerate that shit from bad managers under them and can sniff out a firefighter culture pretty quick.

      I guess what I meant to say was, managers that value doc do exist. If they really do, they’ll let you know.

    • UNWILLING_PARTICIPANT@sh.itjust.works
      link
      fedilink
      English
      arrow-up
      4
      ·
      9 months ago

      Yeah I can’t feel good about that kind of stuff anymore (it’s the same thing in my field with IaC - Infrastructure as Code). Even if I agree that these are good ideas, it all comes down to being able to treat workers like interchangeable cogs rather than people who can amass knowledge and expertise over time.

      Then the dream: that you could sell an entire skeleton of a company with none of the old workers clinging to the bones, and another team of replaceable workers could just slot themselves in place and start making money for investors!

      I’m not sure it’ll ever get that extreme, but it’s not ethics that is blocking it from happening, but material reality.

      So yeah, fuck the docs.

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

        I’m a big fan towards pushing for IaC and configuration as code too. What you have to do is also push for policy as code and finops too keep the managers and power point pushers on their toes too. At least it’s seemed to engender some empathy from some for me.

      • BearOfaTime@lemm.ee
        link
        fedilink
        English
        arrow-up
        4
        arrow-down
        1
        ·
        9 months ago

        I hadn’t considered the impact of IaC type things, but I can see bean counters thinking “well it’s documented, so any monkey will do”, without being able to quantify to lost time/opportunity cost when people have to fumble through.

        In my case, I’m always thinking ahead, trying to see the ways our imperfect systems are going to be a problem, and at least consider high-level options for those things, or for directional change we may see.

        I don’t make any plans, just some notes, in case any of those questions come up.

        Someone unfamiliar with these systems will be in “fix” mode all the time, trying determine why something doesn’t work, and reading through docs trying to comprehend things.