Comment by AdieuToLogic

> A separate document explaining how a system works can go out of date.

Good documentation does not explain "the how", it captures "the why."