On this page
The four parts
| Part | Counts | Points each | Cap |
|---|---|---|---|
| Breaking changes | Breaking changes in the change set | 10 | 30 |
| Affected teams | Consumer teams subscribed to an endpoint with a breaking change | 12 | 36 |
| People to notify | Distinct people in those teams | 1 | 14 |
| Blind spots | Removed endpoints, and breaking changes on endpoints nobody subscribes to | 10 | 20 |
The caps add up to 100. Each part scores the lower of its count times its points, and its cap.
Public rules
The rules are fixed and shown with every score, so you can check the arithmetic.
Informs, never blocks
It helps reviewers decide where to look first. Graphwake never fails or blocks a build.
The bands
| Score | Level |
|---|---|
| 0-29 | Low |
| 30-59 | Medium |
| 60-100 | High |
A change set with no breaking change scores 0: nothing breaks.
A worked example
Hypothetical example: a change set removes one response field and adds a required parameter on another endpoint. That is 2 breaking changes (20 points). Three teams subscribe to the affected endpoints (36 points, which is the cap), and together they have 9 people (9 points). One of the two endpoints has no subscribers: 1 blind spot (10 points). The score is 20 + 36 + 9 + 10 = 75, which is High.
Why a blind spot counts
A removed endpoint, or a breaking change on an endpoint with no subscribers, is a change whose reach is unknown. Counting it as risk pushes the team to find out who is affected before merging. Discovery suggests likely teams, with the reason for each suggestion.
What the score is for
It helps reviewers decide where to look first and who to talk to. With the CI step, reviewers see it while the change is still a pull request.
Questions
What is a good impact score?
Low (0-29) means few or no teams are affected. High (60 and above) means several breaking changes, several teams or blind spots.
Can I see why a change scored what it did?
Yes. Each score is shown with its four parts and the arithmetic.
Pick an endpoint. See who it reaches. 7-day free trial. Cancel before day 7 and you pay nothing.
Start free trial