3 ms·
If people don’t read, it’s their fault. Reading the docs is not a big ask.
by c0pium 3y ago
If 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.