Very carefully - and I mean extremely carefully - word it so that it describes what it does, while implying what it should do without confirming that it actuall

Very carefully - and I mean extremely carefully - word it so that it describes what it does, while implying what it should do without confirming that it actually does that. Also helps if you fix the bug or change the behavior, the docs are still technically correct. I'm only partially kidding, I swear I've seen this a million times in documentation I read.