Spot on. Verbosity for the sake of it sucks, but vague docs on complex systems are even worse. Balance is everything—depth where it actually matters.