flutter/docs/postmortems/postmortem-template.md
Kate Lovett ca198c8585
[wiki migration] Pages under docs/postmortems/ (#148798)
This moves the wiki pages that have a final destination under docs/postmortems/ as planned in [flutter.dev/go/migrate-flutter-wiki-spreadsheet](https://docs.google.com/spreadsheets/d/1x65189ZBdNiLRygpUYoU08pwvXD4M-Z157c6pm8deGI/edit?usp=sharing) 

It also adds the team labels to the label bot for future PRs.

Changes to the content were only updating cross links, or links to refer to the main branch rather than master.
Remaining links to the wiki will be updated once all other pages have finished moving, they still work in the meantime.

Part of https://github.com/flutter/flutter/issues/145009
2024-05-22 05:11:21 +00:00

1.9 KiB

Flutter postmortem: {Incident Title}

Status: {draft|final}
Owners: {who drove the incident resolution}

Summary

Description: {brief description of symptoms and root cause}
Component: {affected area}
Date/time: {YYYY-MM-DD HH:MM}
Duration: {time from initial breakage to final resolution}
User impact: {who was affected by the incident}

Timeline (all times in PST/PDT)

1900-01-01

14:44 - something happened
14:45 - next thing happened <START OF OUTAGE>

1900-01-02

09:12 - another thing happened <END OF OUTAGE>

Impact

{summarize the problems that the outage caused}

Root causes

{without blame, describe the root cause of the outage}

Lessons learned

What worked

{list things where things worked as expected in a positive manner}

Where we got lucky

{list things that mitigated this incident but not because of our foresight}

What didn't work

{list things that failed, with github issues from the action items section}

Action items

{each item here should have an owner}

Prevention

{link to github issues for things that would have prevented this failure from happening in the first place, such as input validation, pinning dependencies, etc}

Detection

{link to github issues for things that would have detected this failure before it became An Incident, such as better testing, monitoring, etc}

Mitigation

{link to github issues for things that would have made this failure less serious, such as graceful degradation, better exception handling, etc}

Process

{link to github issues for things that would have helped us resolve this failure faster, such as documented processes and protocols, etc}

Fixes

{link to github issues or PRs/commits for the actual fixes that were necessary to resolve this incident}

Appendix

{any other useful information, such as relevant chat logs}