Add operational runbooks and decisions stub
This commit is contained in:
30
docs/02-runbooks/compile_error_triage_workflow.md
Normal file
30
docs/02-runbooks/compile_error_triage_workflow.md
Normal file
@@ -0,0 +1,30 @@
|
||||
# Compile Error Triage Workflow
|
||||
|
||||
## Purpose
|
||||
Resolve compile errors quickly using smallest-safe changes and durable prevention notes.
|
||||
|
||||
## Inputs
|
||||
- Failing command output (`./verify-build.bat` or `dotnet test`).
|
||||
- File scope constraints for current task.
|
||||
|
||||
## Steps
|
||||
1. Reproduce with the same command to confirm current error set.
|
||||
2. Classify each error:
|
||||
- missing type/namespace,
|
||||
- bad override/signature,
|
||||
- wrong overload/argument,
|
||||
- C# 5.0 compatibility violation.
|
||||
3. Verify any NinjaScript/API signatures against NT8 docs before editing.
|
||||
4. Apply minimum-diff fix in scoped files only.
|
||||
5. Re-run `./verify-build.bat`.
|
||||
6. Run focused tests for the impacted area.
|
||||
7. If issue is non-trivial, add concise prevention notes to governance docs.
|
||||
|
||||
## Required Output
|
||||
- Error-to-fix mapping (error code, root cause, fix).
|
||||
- Verification evidence (build/test commands and results).
|
||||
|
||||
## Exit Criteria
|
||||
- Build passes.
|
||||
- Relevant tests pass.
|
||||
- Non-trivial learnings are captured.
|
||||
Reference in New Issue
Block a user