It seems that most techies out there are absolutely fine with systems that lack documentation.

If you point out a severe lack of documentation to the average developer, they might agree with your observation, only to shrug it off, as if this isn't a big deal to them.

I almost get the impression that they *like* the lack of documentation, because they get to explore and mess around.

The reason I say this is that poorly documented libraries and frameworks that I wouldn't touch with a ten foot pole are used in a ton of projects out there. People choose to use them, while completely neglecting to quality check the documentation.

I don't like to explore and mess around. I want to get the job done. Having to struggle to figure out how a system works makes me frustrated, and I don't enjoy it at all. Actually taking pleasure from this strikes me as a form of masochism.

@thor the `fucking with shit` gene is strong in techies everywhere. If you like delivering reliable software it's awful

Enforced TDD and semantic versioning can _kind of_ help mitigate this (since you can lock down your API) but it's still tough.

Sign in to participate in the conversation
Mastodon for Tech Folks

This Mastodon instance is for people interested in technology. Discussions aren't limited to technology, because tech folks shouldn't be limited to technology either! We adhere to an adapted version of the TootCat Code of Conduct and have documented a list of blocked instances. Ash is the admin and is supported by Fuzzface, Brian!, and Daniel Glus as moderators. Hosting costs are largely covered by our generous supporters on Patreon – thanks for all the help!