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
Back in the olde days of programming (I'm talking about compilers from the 80s) the coding connoisseur knew that getting a certain error that seemed like nonsense could easily be solved by adding an extra, or removing a remark line from the top of the code and recompiling.