If a team doc needs a Slack thread to explain it, the doc is probably missing the failure case people actually search for.