[wtroughton]

This. The code base should be the authoritative source of the behavior of the system. The comments should be the authoritative source of what is expected of the system.