Change description

The reader is a reviewer or operator with a few minutes who has not read the code. The description is a briefing: it gives them a model of the system as it now stands, shows the decisions they are asked to accept, and lists what they must do to merge and deploy safely.

Only what matters is written. Every line carries something the reader must know or do. A section, step, risk or caveat with nothing important in it is left out entirely, without a placeholder: a body with no deploy steps has no deploy section and no sentence saying so. When unsure whether an item clears the bar, cut it.

Scope