NOTE 03 / SHORT READ

A useful error gives a next step

When something fails, explain what is known and what the person can try next. Avoid claiming a cause that has not been established.

A plain message with a safe next action is more helpful than a decorative code alone. Keep technical detail available where it can help, without making every reader interpret a diagnostic log.