karaterobot
Joined 17 years ago
Joined 17 years ago
I've started having AI write those documents. Each one used to take me a full week to produce, now it's maybe one day, including editing. I don't feel bad about it. I'm ecstatic about it, actually; this shouldn't be part of my job, so reducing its footprint in my life is a blessing. Someday, someone will realize that such documents do not need to exist in the first place, but that's not the world we live in right now, and I can't change it. I'm just glad AI exists for this kind of pointless yeoman's work.
I bought (two different versions of) these apps specifically because they weren't a SaaS suite with a predatory monthly subscription model, and a constant barrage of cross-promotion and integration with their other products.
Now that Figma is public, it's rapidly become another fully enshittified SaaS suite whose only selling point is that there's nothing better out there for now. Affinity is now pivoting in the same direction. What a time to be a designer!
As a developer, I think most documentation is terrible both for developers and non-developers alike. And if you write your documentation so that it is useful to non-developers, it's still useful for developers.
There's no downside to writing accessible documentation, except that it requires a modicum of skill and effort. That's the real reason it's so rare, I think.
I also disagree that developer documentation is like academic papers. The ways they fail are almost opposite: academic papers are overly long and overwritten, because the authors want to be very careful and complete. Developer documentation is too short and hastily written, because they often don't care if it's helpful to anybody else.
The end result may be the same: neither are useful except to a small number of experts: the people who could probably do it themselves already, and thus may not even really need the write up to begin with. But that's a failure, not a feature to be celebrated.
The fact that they've ramped that stuff up so much in the last couple years does not bode well for the future, in my opinion.
My installation isn't associated with a business, it's just a chat board for about 30 people, so there's no question of me being willing to pay $300 a month for the privilege.
I'm sticking with Mattermost because there's no better option, and I've got hundreds of thousands of messages I don't want to lose. However, it isn't like they don't try to extort you just because they're better than Slack about it.
Counter-point: I have a blog I don't want to appear on search engines because it has private stuff on it. 25 years ago I added two lines to robots.txt file, and I've never seen it show up on any search engine ever since.
I'm not pretending nobody has indexed my blog and kept a copy of the results. I'm just saying the blog I started in college doesn't show up when you search for my name on Google, which is all I care about.