Coda to Avery's Observation

Those outside don't understand the hard parts well enough to document them, of course. If they learn them well enough, then they at least start to suffer from the same problem the developers have. It really takes a rare partnership to create great docs.