this post was submitted on 17 Oct 2024
25 points (93.1% liked)

Old Man Yells at Cloud

42 readers
1 users here now

So I tied a Tamagotchi to my belt, which was the style at the time

Are you a tech enthusiast who also kind-of hates current tech trends? This community is a place to share your gripes with modern technologies, tech-bro culture, "AI the everything", etc.

Tech-rant memes, articles, or just rant/horror stories: all are welcome.

Related Communities

founded 1 year ago
MODERATORS
 

And if you're assuming the software vendor I'm dealing with was the lowest bidder, you are correct.

you are viewing a single comment's thread
view the rest of the comments
[–] [email protected] 3 points 2 months ago (1 children)

Like, all these projects are built by unpaid volunteers and have amazing documentation. We’re paying you a lot of money - what’s your excuse?

This is so true and it boggles my mind.

I understand the open source side of things. I write good documentation because every minute I spend on that saves me an hour in answering questions. It also helps any new employees get up to speed. And honestly, it helps me keep up to speed because I'm way too old to keep all this stuff in my brain long-term. I can't remember half the shit I did last year. Not in sufficient detail, anyway. I'm kicking myself now for not documenting all the steps I took configuring my personal Linux desktop, because I hopped distros and now I have to re-learn things I haven't done in years.

I don't understand the commercial side of things, because...aren't you paying your support people? Isn't that time costing you money?

Is the issue that the salary of the people with the technical knowledge to write good documentation is much higher than the support staff? Is it that paying customers by and large will not read documentation anyway? Is it because they are reserving the right to change everything radically without notice, and to hell with semantic version numbering?

Or is it that operational/ongoing expenses are easier to justify to beancounters than capital/one-time expenses in general? (Which seems totally backwards to me.)

[–] [email protected] 2 points 2 months ago

Anecdotal, but in my org's case, vendors providing little to no documentation seems to be due to one (or more) of a few things:

  1. Ensuring an ongoing support contract that wouldn't be needed if the product were properly documented (this is in addition to the software maintenance contract for updates/patches).
  2. Nudging us toward their hosted, SaaS solution (and significantly higher ongoing costs)
  3. They're just generally terrible in one or more ways: writing documentation, disorganized development and project management practices, etc.

My org is a non-profit that deals with environmental remediation and often has to electronically submit data to the US EPA to qualify for grants, so pretty much all of the software we use is niche; more often than not, the lowest bidder is also the only bidder and we have to take what we can get. :sigh: