Skip to content

Commit

Permalink
Merge pull request DataDog#17 from github/attamusc/feat/add-fr-docs
Browse files Browse the repository at this point in the history
feat: Add initial FR docs
  • Loading branch information
Attamusc authored Dec 1, 2022
2 parents 9d3dca2 + 96ceed6 commit 11c6941
Showing 1 changed file with 55 additions and 0 deletions.
55 changes: 55 additions & 0 deletions docs/first-responder.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
# First Responder

First Responders are expected to be available during their own working hours, for one work week (no weekends).

## Why have a First Responder?

- Facilitate ability for non-responders to focus more deeply while one team member responds to synchronous and/or urgent tasks.
- Reduce context shifting among non-responders.
- Ensure our stakeholders and partners have an engineer available to engage with them.
- Be a learning and growth opportunity for team members, to gain exposure to more of our areas of responsibility.
- 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.**

## How to First Responder

### Beginning of week

- [ ] Set the `#monolith-platform` Slack channel topic to `:first-responder: <your-handle>`.
- [ ] **(optional)** Set your slack status emoji to `:first-reponder:` to call out that your on an FR rotation to others.
- [ ] **(optional)** Enable slack notifications on the `#monolith-platform` channel.
- [ ] 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.

### Throughout the week

- [ ] Help unblock teammates.
- [ ] 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.
- [ ] Review `#monolith-platform` for notifications throughout each day.
- [ ] 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.**
- [ ] Team pings can be reviewed in `monolith-platform-ops` using the `github/first-responder` tooling chatops (see `First Responder tooling` below)
- [ ] For questions, try to follow this workflow:
- [ ] If you know the answer, reply to the person asking the question.
- [ ] 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.**
- [ ] 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).
- [ ] 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).
- [ ] Keep an eye on channels we help staff:
- [ ] `#monolith-platform`
- [ ] `#sorbet`
- [ ] `#dotcom-codespaces`
- [ ] Check the [first responder board](https://github.com/orgs/github/projects/7910) for small, refined tasks to take on.
- [ ] If things are quiet, contribute to normal Epic work. If unsure what to focus on, reach out to @attamusc.

### First Responder tooling

#### chatops

| Action | Chatops command |
| -------|-- |
| View active notifications | `.fr new` or `.fr sup` |
| Hide a notification from .fr new | `.fr hide <url>` |
| Add an issue to .fr new | `.fr unhide <url>` |

## End of Shift Report

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.


0 comments on commit 11c6941

Please sign in to comment.