Good documentation will commit as much as possible to paper: to turn the implicit into the explicit. But then ya gotta keep it up to date.