Product Reference Documentation
How can we help you?
Browse our help section, visit our subreddit, send us an email, vote on new features, or search below.
Quick Start Guide
Benchmark unit: One Facebook React Day (FRD)
Choosing preferred "Default Report," collecting your favorite charts into one place
Developer analytics terminology: concepts, lexicon, and dictionary to talk productivity & code quality
Importing repos to GitClear
New users' Frequently Asked Questions (FAQ)
Programming languages (file types) processed by GitClear
Quick start guide: Commit Activity Browser
Starred Reports: Gather favorite GitClear reports into a single dashboard
Tailor Goal & Activity Notifications to Maximize Relevance
Troubleshooting your repository imports
Use the GitClear Rest API
Code Review & Navigation
Commenting on code, commits, or pull requests
Commit Activity Browser: use cases and configuration options
Commit Activity Browser: Visual Usage Guide
Commit Groups: Combine the benefits of frequent committing with the brevity of squash merge
Different ways to choose repo, organization & team data being viewed
Diff Viewer: Visualize code changes
Directory Browser: Where is time and energy focused in this project?
File/directory ignore masks prevent noise
Recent Activity Summary: Instant visibility into team's recent issues, PRs, branches across repos
Specify a string that designates a file as "auto-generated"
Code Quality
Bug Work Percent graph
Code quality stat: Moved and Copy/Pasted (Duplicated) line percentage
Code Quality Stats: Overview of stats to gauge long-term velocity prognosis
Code quality targets: Advice on specific, substantiated goals for code quality
Code reactions help track developer sentiment
Detecting bug sources: which files and directories are causing problems?
Diff Delta as an incentive to improve code health
Duplicate code block detection
Quality Cornerstones Percent graph
Tech Debt Inspector: List of lowest velocity directories
What constitutes a "Meaningful Code Line Change" in GitClear?
Diff Delta & Time Estimation
API Data Caching Limits (data preservation window)
Best practices to ensure accurate time estimation and commit group building
Configuring and using Code Domains
Customizing code file types
Diff Delta Benchmarks: What does it mean to accumulate 100k or 1m Diff Delta?
Diff Delta Explained: Calculation, Operations and Idioms
How GitClear estimates time used (minutes, hour, days) per commit
Understanding Diff Delta, developer productivity metric, from first principles
What is the "Commit Cruncher"?
When and why does Diff Delta change after being calculated?
Which branches are assigned Diff Delta?
Delivery Velocity
Delivery Velocity stats (Diff Delta History)
Developer Calibration Calculator: How closely does your intuition align with code metrics?
Hourly Delta Graph Overview
Hours Coding Estimate graph
Industry Benchmark Lines: Enabling industry stat comparisons within charts
Using Per-Contributor (Per-Developer) Stats
Using the Cohort Report to improve developer onboarding
Velocity Consistency Stats
What is "code provenance" and why does it matter?
Which developers have been most prolific in which technologies? (Domain Experts report)
Developer Experience (DevEx)
Committer Changelog editing from the "Changelog Review" tab
Developer Annual Performance Reviews -- Without the Recency Bias
How to publish work via Snap Changelog
Measuring Developer Satisfaction via Sentiment Surveys
Minimalistic committing: a modern git commit strategy explained with examples
Progress updates through a png: Snap Changelog concept & config options
Recording Time Off (Planned/Excused Absences)
Team goals: Pick up to 30 team goals to ensure code quality, developer experience, more
Weekly Developer Highlights Email: Recognition for a job well-done
Issue & Defect Tracking
All issue tracker stats available: Overview with screenshots
Connecting to Jira and maintaining issue tracker connection settings
How to reference an issue in Jira or GitHub
Issue Browser: Analyzed, actionable data for a specific sprint or moment in company history
Issue tracker ticket transitions: setup and use
Setting up Slack notifications for GitClear goals & alerts
Story Point setup and correlation
Using Issue Mapping for advanced commit/issue connectivity
Pull Requests
Classic Pull Request stats: how to optimize what matters for long-term health
Collaboration stats: review count, duration, comments per PR, more
Exclude a bot from pull request review stats
GitHub Chrome Extension: Review Less Code per PR
Overview of Pull Request Tabs
Rebase, Merge Commit, or Squash: Details of how completed pull requests distribute Diff Delta
Reviewing code: Saving 20-30% on PR review vs. GitHub and other Myers-based diffs
Reviewing pull requests: discussion, overview, code quality, problem detection
Set threshold targets for PR size, tests, documentation
What is considered an "Unreviewed PR," and how to see when they happen?
Google DORA Stats
2023 Google DORA Devops Report: Three Practical Takeaways
Critical Defect Data Browser: Learning from past challenges via granular data
Critical Defects: Overview and setup of a DORA pillar
Distilled summary of 2024/2025 Google DORA Report
Distilled Summary of Google's 2023 DORA report
Free Google DORA and Code Quality report delivered to your inbox
Google DORA 2023 Research Questions
Google DORA in detail: precise definitions, specific units and examples
Release (Deploy) tracking setup
What are the Google DORA stats, and how to interpret your own DevOps performance?
Account Setup & Management
API quotas for importing repositories
Automatic import of new repos
Enterprise: Enabling SSO support with SAML
GitClear Ambassadors: terms and conditions overview
How do I set up teams and control the access of team members?
How do I unlink my repositories?
How to invite new users to GitClear
Installing our on prem Enterprise edition
Setting up a new API connection in GitClear Enterprise
Sync teams from an external git provider
Billing & Subscription
Bot processing: What gets processed, how to change it?
Contributors List: Merge, Exile, Change Seats for Contributors
How do I cancel my account?
Pricing: what is an "active contributor"?
Starter Plan subscription: Free, lightweight measurement & changelogs
Subscription Seats and Active Contributors
Use Cases
Automated Changelogs: Publish Illustrated Progress for Customers, and Weekly/Annual Reviews
Example Commit Group patterns found in Commit Activity Browser
Find the best developer for a Jira
GenAI Impact: 7 metrics to track before adoption
How does your dev team compare to industry leaders?
How is your new developer ramping up? Do they need help they're scared to ask for?
How to promote developer buy-in of GitClear?
Identify and assist struggling Developers
Who from the team is the expert in a technology?
Security
Accessing a committer's individual report data
Are Developer Analytics tools like Big Brother?
Configuring security permissions (OpenAI, research)
How can I report a security concern?
How do I revoke access to my git provider?
Network & server security
Product security overview
Source code protections
What do you do with each of the authorizations you ask for?