When the map and the territory don’t agree, always believe the territory.
— Jerry Weinberg —
What does this have to do with software? Everything!
This dictum is valid in many ways:
- Does your documentation really match your software?
- If the software metrics are good, why is your software maintanence department so busy?
- The software is built conform specifications, why are users complaining?
- Are you confused/upset about a missed deadline, perhaps the plan (the map) doesn’t match reality (ouch).
My advise? Update your map, so it matches the territory. Oh, I understand that’s hard and possibly painful (on limited resources like time, money, manpower), but not updating .. is that really an option?