You are right! You said just what David Parnas keeps saying. People don't know what or how to document because they weren't taught to do it. It's not common knowledge. One has to dig into reading books and papers just to get the idea that it is possible.