Skip to main content
All CollectionsOnboarding
GitHub data backfill for DX Onboarding
GitHub data backfill for DX Onboarding
Updated over a week ago

Introduction

DX onboarding uses pull request merge rates to measure ramp-up time. When you first enable DX onboarding, you may notice inaccurate or missing ramp-up time metrics. This is due to missing historical data. To backfill the data, you'll give DX a GitHub API token and your organization's slug.

Steps to get your organization's slug

1. Go to your organizations page and copy the text there.

Steps to create the API token

1. Go to your personal access tokens page and click "Generate new token (classic)".

2. Select the "repo" and "admin:org > read:org" scopes. You can revoke the token once the backfill is completed.

If you'd like to use a fine-grained token, select the following permissions:

  • Select "All repositories", then under "Repository permissions" enable "Pull requests > Access: Read-only"

  • Under "Organization permissions", enable "Members > Access: Read-only"

What DX does with your API key:

  1. Get a list of contributors in your org

  2. Get each contributor's earliest 10 PRs

  3. Store the PR merge timestamps to calculate time-to-Nth PR metrics

Did this answer your question?