Post-mortem

Each outage that affects the production environment or affects the build process for a substantial amount of time should be documented, so that the engineering team can learn and avoid the same mistakes in the future.

For that to happen, we are using the post-mortem documents that are stored in the reports folder.

The Procedure

The procedure for creating such document is as follows:

• create a new file in the reports folder
• use the template as the source for the structure of the created file
• fill out the information
• remove all placeholder text and all optional sections left empty
• create a new pull request and add the engineering team as the reviewers
• the pull request can be merged once it is approved
• introduce improvements to avoid similar risk in the future