Focused Guide

What GitHub Counts as a Contribution

2 minute read

Open the contribution graph and you see a calendar of squares that reflect activity the platform can verify. The pattern is built from specific events that match GitHub’s published rules. That scope is intentional. It keeps the graph consistent, but it also means not every kind of software work will appear there.

What the graph is built to show

The graph follows qualifying activity on GitHub. When actions match the platform’s contribution rules, they can appear in the daily count. The rules are documented by GitHub and focus on events the service can record reliably in repositories and related processes. This keeps the display stable across projects and time.

Because the graph is tied to those rules, it is not a diary of your entire day. It does not attempt to summarize planning, learning, informal collaboration, or decisions made away from the platform. It reflects platform events that meet the criteria, not the full mix of effort that led to them.

Two ordinary contrasts

• A qualifying commit or pull request interaction that meets GitHub’s rules can produce a square on the day it occurs.
• A day spent on private, internal, or otherwise nonqualifying work may not show in the same way, even if the work mattered to the project.

These contrasts are not errors. They are consequences of a clear boundary. The graph is strongest when it remains a record of what the platform can count. Treating it as an account of everything makes the display feel wrong, when the real issue is the mismatch between the record and the larger practice it sits inside.

Why this boundary helps

GitHub documents specific qualifying events under its contribution rules, not every form of planning, learning, collaboration, private work, or maintenance. That limitation keeps the graph meaningful and comparable. It also explains why a green square can come from a small event, and why a full day of valuable work can remain invisible there.

Knowing that scope does not tell you what to value. It gives you a clearer picture of what the grid is actually showing so you can read it accordingly and look elsewhere for the parts of the work that live off the platform.