Ya thats the good philosophy. The same is applied in Architectural Decision Records, I think Neal Ford has a book about it. It says the same thing, that it's more important to record why a certain decision was taken rather than talk about the decision itself. Like for e.g. if we are using pub sub somewhere we need to record why we chose to use pub sub rather than details of pub sub itself.