NSTD-INCIDENT - Repair a fluent account that implies an unsettled cause
- Situation: An incident account turns an observed sequence into an established causal explanation.
- Question: How can it explain the known events and decisions while preserving what remains unresolved?
- First useful result or blocker: An account of what happened, including the limits of the available causal evidence.
- Start with: Use NSTD.3 to examine the connections drawn from the log for this audience.
- Stop or return: Finish when the account answers the question. If a causal conclusion is needed, use an adequate investigation result or identify what remains to be established.
Suppose a service log records a configuration change at 14:00, failed requests at 14:02, a rollback at 14:05 and restored service at 14:07. The investigation is still open. A draft report says the change caused the failures and the rollback restored the service.
The team uses NSTD.3 to compare the two causal claims with the log. With NSTD.2 it can present the events in order. The setting changed before the failures, and service returned after the rollback. The log leaves the causes of the failure and recovery open. That account answers a question about the observed sequence. A remedy that depends on either cause needs evidence for that link.
Use NSTD.4 to examine what the operator could see at the time. A record of what the operator saw and why they acted can explain the rollback decision. Responsibility for the original failure requires evidence about that failure. Include another recorded condition if it changes the interpretation. With NSTD.5 the writer can convey the urgency and leave the cause open.
Use NSTD.6 when the suitability of the repaired account needs evaluation. A walkthrough or formal estimate can show what a reader could recover under stated conditions. To establish what a reader actually understood, examine their response and the help they used. For example, can they reconstruct the sequence, identify a proposed cause and say what evidence a remedy would require? If wording or order led them to infer a settled cause, repair the affected passage and examine the result as needed. If an investigation later establishes the mechanism, revise the claims that depend on it.