Submit an incident
A real failure mode from a real system, not a topic.
p99 is an archive of production incidents, and contributions are welcome. The fastest route is a pull request — you do not need to touch any application code, just one new file plus one line in the registry.
- Fork the repo and branch off
main. - Copy
content/incidents/TEMPLATE.mdto a new file namedNNN-your-slug.ts— every field is commented. - Fill in the symptom, constraints, evidence, question, picks, diagnosis, fix, rubric and the three compressed lessons.
- Register the new file in
content/incidents/index.ts. - Run
npm run lintandnpm run build, then open the PR.
One incident per PR, do not edit other incidents in the same PR, and check that your answer id matches one of its option ids — the build will not catch that one.
Contributing guide
The full walkthrough, guidelines and CI details.