this post was submitted on 08 Feb 2024
616 points (99.0% liked)
Technology
59578 readers
3120 users here now
This is a most excellent place for technology news and articles.
Our Rules
- Follow the lemmy.world rules.
- Only tech related content.
- Be excellent to each another!
- Mod approved content bots can post up to 10 articles per day.
- Threads asking for personal tech support may be deleted.
- Politics threads may be removed.
- No memes allowed as posts, OK to post as comments.
- Only approved bots from the list below, to ask if your bot can be added please contact us.
- Check for duplicates before posting, duplicates may be removed
Approved Bots
founded 1 year ago
MODERATORS
you are viewing a single comment's thread
view the rest of the comments
view the rest of the comments
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.
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.
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.
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.
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.
An interesting proposition, and one I'll be thinking about for sure. Sadly we probably won't ever get "VC as Code" hah so none of us are safe
The crypto space is convinced they are that. ICOs instead of IPOs. DAOs instead of boards of investors. Etc.