38 lines
784 B
Markdown
38 lines
784 B
Markdown
---
|
|
title: [Clear problem title]
|
|
date: [YYYY-MM-DD]
|
|
category: [docs/solutions subdirectory]
|
|
module: [Module or area]
|
|
problem_type: [schema enum]
|
|
component: [schema enum]
|
|
symptoms:
|
|
- [Observable symptom 1]
|
|
root_cause: [schema enum]
|
|
resolution_type: [schema enum]
|
|
severity: [schema enum]
|
|
tags: [keyword-one, keyword-two]
|
|
---
|
|
|
|
# [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]
|