"Don't make me think (unnecessarily)" is just one of several good ideals for scalable and maintainable projects, because valuable code is easy to learn and easy to add to. And since the code and doc is a shared, collaborative description of machine behavior, it should help new people understand tradeoffs, motivations for engineering decisions and history to better use or add to it.