By connecting Socratic with GitHub, you can see code metrics for people, teams, and for your organization as a whole. These metrics are surfaced on Trends.

Set up

1. Connect Socratic

To activate for your org:

  1. Click the Socratic icon at top left, and choose Integrations.

  2. Click on GitHub. Click the Connect GitHub button.

After connecting, Socratic will analyze the last year of activity data in GitHub for your organization. This analysis may take up to 24 hours to appear in Socratic.

2. Map GitHub IDs to their corresponding contributor

To see code metrics for people and teams, you need to first map GitHub IDs to their corresponding contributor name in Socratic. (Contributors are those people whose Jira work activity Socratic instruments. Contributors are automatically discovered by Socratic.)

  1. Click Add users in the lower-left of the app.

  2. Click the Contributors tab at the top of the page.

  3. Click the Map GitHub users button at the top-right of the page.

Socratic will show all the GitHub IDs discovered in connecting to your GitHub account. We will also "suggest" a mapping between GitHub IDs and contributor names. Accept or change the suggested mapping for each contributor. Then again click the Map GitHub users button to confirm all pairings.

How to see and use code metrics

Socratic surfaces code metrics on Trends. You can see these metrics for:

  • A person: click Capacity in the left-hand navigation, then click any name. For each person with a mapped GitHub ID we surface: merge time, review time, merged pull requests, and pull requests reviewed.

  • A team: click Teams in the left-hand navigation, and choose any team. For teams we surface: merge time, review time, and merged pull requests.

  • Your organization: click Trends in the left-hand navigation. For your organization as a whole we surface: merge time, review time, and merged pull requests.

As with all Trends data, we show the relevant code metric for the selected time period, and as trended against the average for the prior five equivalent periods. For each code metric, you can click to see the pull requests and repositories involved for the period in question.

Last updated