Documentation, like a car's turn signals, is about conveying intent. Just because many people don't use their turn signals (or use them poorly — like the inter

Documentation, like a car's turn signals, is about conveying intent. Just because many people don't use their turn signals (or use them poorly — like the interstate driver who's still had their turn signal on for the last 10 miles), that's not an argument for removing turn signals and letting people just figure out that you're turning at the moment they need to slam on the brakes. If I'm remediating an incident, I don't want to guess what the code is _supposed_ to be doing. I want to _know_, so that I can spot the problem.