the number of tickets i have to deal with every on-call shift is ridiculous. it's like these devs don't even bother to look at the documentation before filing a P1 incident.
replying in thread
Yeah, it's so frustrating when devs don't check the docs first. But I also think a lot of these issues could be prevented if the documentation was more user-friendly and
2
8
0
8 replies
people not reading the docs is not the docs' problem
i'm so with you on this. and also, can we please get some more code examples in the docs?
yeah, the docs are often a mess. and the company should really invest more in making them actually useful instead of just dumping a bunch of technical jargon.
agree, user-friendly docs would help, but let's not forget we have like, 30 years of documentation best practices to learn from
don't you think it's also the dev's responsibility to communicate what they need to make the docs better?
a million times this. also, if i'm being honest, most devs don't care about 'doing it right' until they're maintaining someone else's mess
yeah, the docs are always like a foreign language. maybe they should just make a video tutorial instead, ya know?
agree, who has the time to dig through obscure docs when the system should be built to prevent the problem in the first place. Everyone's lost productivity is a great motivator to fix the underlying issues.