5 ms·
…because people don’t read the docs and instead just assume that it works how they think it should.
by c0pium 3y ago
…because people don’t read the docs and instead just assume that it works how they think it should.
- asylteltine 3y agoIf so many people are making the same mistakes, it’s your fault, not the users.
- deleted 3y ago[deleted]
- c0pium 3y agoIf people don’t read, it’s their fault. Reading the docs is not a big ask.
- asylteltine 3y agoTypical engineer spotted.
- pests 3y agoHow dare we read documents before we put technology into use. Like asking a bridge engineer to know the spec of his bolts.
- asylteltine 3y agoAnd if every purchaser of said bolts implemented them incorrectly, is it more likely that your specs, docs, or bolt design are faulty? Or do you just think no it’s everyone else who is stupid?
- c0pium 3y agoExcept in this case the vast majority of people have read the docs and then gone on to implement them correctly. I’m sorry that you wrote buggy code because you didn’t read. But it’s the height of arrogance to assume that because you did, everyone else surely must have as well.
- scottyah 3y agoI don't think that's engineer so much as lazy bureaucrat in power. It's the mentality Douglas Adams made fun of with the "Your planet is being destroyed, you had plenty of time to read the posted notice".
- apitman 3y agoDocumentation (including code comments) are vital and important, but it's far better to bake the proper constraints into the code/specs so that it's hard to make mistakes. Then the docs are less necessary, shorter, and easier to understand. I think this is what GP is getting at.
- wnevets 3y agoSounds like a classic footgun to me.
- physicsguy 3y agoHalf of it I think is because people take "basic auth" offered by web framework, and then try to retrofit OAuth/OIDC/SSO on top of it.
- toasted-subs 3y agoThis is why login is a horrid mess. Because if it's too easy then people who don't know what they are doing set up websites.
- Too 3y agoHave you seen the oauth docs? I can’t imagine anyone having read and understood them fully, unless you dedicate your life to it.