The problem often becomes that even if it is written, the documentation is rarely or never read. People then wonder if they should write more or less and why it is this way. I think one of the problem is we think we are finished after we write it. I would like to see a place where someone went over the documentation and rewrite it to extract the cultural references instead of the specifics of one situation. The documentation would be more about how to react than what to do exactly.