📝By documenting a design, the designer exposes himself to the criticism

tags
§ Software Design
source
Brooks1995, p. 118

By documenting a design, the designer exposes himself to the criticism of everyone, and he must be able to defend everything he writes. If the organizational structure is threatening in any way, nothing is going to be documented until it is completely defensible.

—John Cosgrove, “Needed: A New Planning Framework,” Datamation 17-23

The organization must provide safe environment to expose designs. Designs are better treated as preliminary decisions. They should be reviewed, but the person’s performance shouldn’t be judged from the design.

Backlinks