Skip to content

Commit 11c6941

Browse files
authored
Merge pull request DataDog#17 from github/attamusc/feat/add-fr-docs
feat: Add initial FR docs
2 parents 9d3dca2 + 96ceed6 commit 11c6941

1 file changed

Lines changed: 55 additions & 0 deletions

File tree

docs/first-responder.md

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
# First Responder
2+
3+
First Responders are expected to be available during their own working hours, for one work week (no weekends).
4+
5+
## Why have a First Responder?
6+
7+
- Facilitate ability for non-responders to focus more deeply while one team member responds to synchronous and/or urgent tasks.
8+
- Reduce context shifting among non-responders.
9+
- Ensure our stakeholders and partners have an engineer available to engage with them.
10+
- Be a learning and growth opportunity for team members, to gain exposure to more of our areas of responsibility.
11+
- The first responder may also be pinged through PagerDuty if a high severity issue related to an AOR the team owns arises. **Note: Very few areas we own have SLOs that trigger an alert, so these will mostly likely be manual triggers from someone.**
12+
13+
## How to First Responder
14+
15+
### Beginning of week
16+
17+
- [ ] Set the `#monolith-platform` Slack channel topic to `:first-responder: <your-handle>`.
18+
- [ ] **(optional)** Set your slack status emoji to `:first-reponder:` to call out that your on an FR rotation to others.
19+
- [ ] **(optional)** Enable slack notifications on the `#monolith-platform` channel.
20+
- [ ] Review our [owned services](https://catalog.githubapp.com/services?group=all&filterID=&filter=team.name%3Agithub%2Fmonolith-platform), [create Issues](https://github.com/github/monolith-platform/issues/new/choose) for any recurring problems you notice that aren't tracked.
21+
22+
### Throughout the week
23+
24+
- [ ] Help unblock teammates.
25+
- [ ] Be the first point of contact for [Pull Request](https://github.com/search?q=is%3Aopen+is%3Apr+team-review-requested%3Agithub%2Fmonolith-platform-reviewers+draft%3Afalse+-label%3Atriage&type=pullrequests) reviews.
26+
- [ ] Review `#monolith-platform` for notifications throughout each day.
27+
- [ ] Triage new issues that pop up in the [first responder board](https://github.com/orgs/github/projects/7910). **Note, this board is populated by the github/first-responder tooling.**
28+
- [ ] Team pings can be reviewed in `monolith-platform-ops` using the `github/first-responder` tooling chatops (see `First Responder tooling` below)
29+
- [ ] For questions, try to follow this workflow:
30+
- [ ] If you know the answer, reply to the person asking the question.
31+
- [ ] If you don't know the answer immediately, let the requester know that you're researching their problem, and will get back to them. Look through the Hub, documentation, relevant code, and/or ask in the team channel to try to find an answer. **Don't get too hung up on if you can't find an answer. This should be a good effort investigation to make progress, not to solve the ask wholesale.**
32+
- [ ] If you're not sure of the answer after research, ask the requester to open an [issue in our repo](https://github.com/github/monolith-platform/issues/new).
33+
- [ ] For a request for work that comes in through Slack, ask the requester to open an [issue in our repo](https://github.com/github/monolith-platform/issues/new).
34+
- [ ] Keep an eye on channels we help staff:
35+
- [ ] `#monolith-platform`
36+
- [ ] `#sorbet`
37+
- [ ] `#dotcom-codespaces`
38+
- [ ] Check the [first responder board](https://github.com/orgs/github/projects/7910) for small, refined tasks to take on.
39+
- [ ] If things are quiet, contribute to normal Epic work. If unsure what to focus on, reach out to @attamusc.
40+
41+
### First Responder tooling
42+
43+
#### chatops
44+
45+
| Action | Chatops command |
46+
| -------|-- |
47+
| View active notifications | `.fr new` or `.fr sup` |
48+
| Hide a notification from .fr new | `.fr hide <url>` |
49+
| Add an issue to .fr new | `.fr unhide <url>` |
50+
51+
## End of Shift Report
52+
53+
Add a comment to the [first responder roll-off discussion](https://github.com/github/monolith-platform/discussions/16), describing how the week went and highlight what you think is relevant for the next First Responder.
54+
55+

0 commit comments

Comments
 (0)