I work in IT. My boss is by all accounts very competent in both programming and administration, yet all his documentation basically says "remember to set DoTheRightThing=True"
Edit: I just looked up the documentation for an internal service and under "Error recovery" it just says "The output of command xy should make sense". fml