Explain Code Experts

Post a comment that uses git blame and history to list the most relevant experts for all PRs. The comment will automatically update as additional commits are added to the PR.

If your repository has formatting-only commits or mechanical migrations that should not count toward expertise, list those commit SHAs in .git-blame-ignore-revs. The blame-based calculation used by this automation excludes those revisions from code expert attribution.

Configuration Description

Conditions (all must be true):

The PR has the 'suggest-reviewer' label.

Explicit Triggers:

When a PR is created (pr_created)
When a PR becomes ready for review (pr_ready_for_review)
When a new commit is pushed to the PR (commit)

Automation Actions:

Post a comment that identifies the people with the highest level of code expertise.

Explain Code Experts

# -*- mode: yaml -*-

manifest:
  version: 1.0

automations:
  explain_code_experts:
    on:
      - pr_created
      - pr_ready_for_review
      - commit
    if:
      - {{ pr.labels | match(term='suggest-reviewer') | some }}
    run:
      - action: explain-code-experts@v1
        args:
          gt: 10

Download this example as a CM file.

Additional Resources

gitStream is a workflow automation tool that enables you to use YAML configuration files to optimize your code review process. Add context to PRs, find code experts for reviews, and automate the merge process to maximize developer productivity.

Learn More about how gitStream Works.

Related Automations:

More Automations can be found on the Automation Library and Integrations pages.