We were asked to review a contract for implementation of enterprise software for an airline, and hosting of that software in the supplier’s data centre.
The contract for the implementation project contained a lengthy description of the functionality of the software modules that made up the package. There were five modules, although it was impossible to determine this from reading the description.
The customer’s project manager had worked on the project for many months, and knew each module intimately. He was surprised when we recommended that the schedule included a table of module names and version names on the first page.
But that small change made the contract intelligible to those who lacked his intimate knowledge (i.e. everyone but him).