title, date, category, module, problem_type, component, symptoms, root_cause, resolution_type, severity, tags
| title |
date |
category |
module |
problem_type |
component |
symptoms |
root_cause |
resolution_type |
severity |
tags |
|
|
|
| docs/solutions subdirectory |
|
|
|
|
|
|
|
|
|
[Clear problem title]
Problem
[1-2 sentence description of the issue and user-visible impact]
Symptoms
- [Observable symptom or error]
What Didn't Work
- [Attempted fix and why it failed]
Solution
[The fix that worked, including code snippets when useful]
Why This Works
[Root cause explanation and why the fix addresses it]
Prevention
- [Concrete practice, test, or guardrail]
Related Issues
- [Related docs or issues, if any]