Problem

Have to trawl through a repo to check whether they have swagger docs / where their doc is hosted (/docs, /documentation, /something else)

First suggested by @arshadali172, to have guidelines and clarifications for what a runbook should look like

Sth @liangyuanruo mentioned at the meeting today!

See https://github.com/opengovsg/meta/projects/3#card-67041552

This issue is to clarify the procedures necessary for teams to move towards central incident management procedures on OpsGenie.

Topics to describes:

• Updating dependencies
• Monitoring and patching security vulnerabilities
• For fork repos, keeping up with upstream, try to have changes adopted upstream
• Continuous improvement on logging, monitoring and alerting

They currently exist on Google docs

Write guidelines to describe how new ideas or practices with a broad impact should be discussed and adopted and documented:

Request For Comments (RFC)

• Describe idea proposed
• Present POCs / MVPs / experimentation with results
• Should be in a format that makes discussions very easy (github PRs may not be the best format for this)
• Described other approaches that have been considered
• Eventually document decision

Architecture Decision Record (ADR)

• Describe a particular decision taken and rational
• Describe Impact to organisation and teams
• Ideally links to an RFC so people may get more contextual information should they wish

Add links to all product repos