Skip to content

Profile Contribution Matrix#43989

Open
manuelgruber wants to merge 9 commits intogithub:mainfrom
ZAAI-com:Profile-Contributions-Matrix
Open

Profile Contribution Matrix#43989
manuelgruber wants to merge 9 commits intogithub:mainfrom
ZAAI-com:Profile-Contributions-Matrix

Conversation

@manuelgruber
Copy link
Copy Markdown

@manuelgruber manuelgruber commented Apr 26, 2026

This PR adds a quick-reference table near the top of the page. For each action and each type of repository, the table shows at a glance whether the action counts as a contribution. The existing rules in the prose below stay unchanged and remain the full reference.

Why:

The current page explains when an action counts as a contribution through several paragraphs and a nested bullet list. The rules interact across multiple dimensions, so answering a concrete yes-or-no question means cross-referencing several sections and many readers stop before they get there. This change adds a clear visual representation of the rules at the top of the page.

What's being changed:

A new Profile Contribution Matrix section in profile-contributions-reference.md, plus a link to it from troubleshooting-missing-contributions.md.

The matrix:

Own Repository Repository Fork → Upstream Other Repository
Repository Type Standalone Fork Standalone Standalone
Create

🟩
🟩




Commit
To default branch 🟩 🟩 ⬜ 🟩
To gh-pages branch 🟩 🟩 ⬜ 🟩
To other branches
Pull Request
Open PR 🟩 🟩 🟩
Review PR 🟩 🟩 🟩
Collaboration Channels
Create new Issue 🟩 🟩 🟩
Comment on Issue
Start new Discussion 🟩 🟩 🟩
Answer Discussion 🟩 🟩 🟩

Cell legend:

  • 🟩 counts as a contribution
  • ⬜ does not count
  • ⬜ 🟩 conditional (the ⓘ tooltip on the cell describes when it counts)
  • – not applicable

Check off the following:

  • A subject matter expert (SME) has reviewed the technical accuracy of the content in this PR. In most cases, the author can be the SME. Open source contributions may require an SME review from GitHub staff.
  • The changes in this PR meet the docs fundamentals that are required for all content.
  • All CI checks are passing and the changes look good in the review environment.

- Move "Upstream ← Fork" column to rightmost position and rename to "Fork → Upstream" so directionality reads left-to-right
- Split combined commit row into separate "default branch" and "gh-pages branch" rows so the matrix is self-documenting
- Replace undefined "(RW)" shorthand with the standard ⓘ tooltip icon used elsewhere in the table
- Clarify "Fork" column tooltip and refine the per-branch Commit tooltips
…ntributions Matrix

- Add a dedicated "Commit" headline section before "Contribution Channels"
- Move the three commit rows (default branch, gh-pages, other) under it
- Drop the redundant "Commit" prefix from those rows and start them with "To" since the headline now carries the context
…ip as a lettered list

- Rename "Open Issue" → "Create new Issue", "Answer Issue" → "Comment on Issue", "Open Discussion" → "Start new Discussion" for clearer GitHub terminology
- Use HTML 
 line breaks to render the conditions in the Commit-row tooltip as an (a)/(b)/(c) list, matching the wording of the corresponding bullet list further down the page
…n Matrix

- Rename "Profile Contributions Matrix" → "Profile Contribution Matrix" and update the inbound link in troubleshooting-missing-contributions.md
- Shorten the Fork→Upstream column header to "→ Upstream" with a clearer location-based tooltip
- Rename "Repository" → "Own Repository" with a precise tooltip; rename "Fork" → "Repository Fork"
- Add a rightmost "Other Repository" column whose tooltip spells out the (a)/(b)/(c) exclusions
- Use ⬜ 🟩 + ⓘ in Other Repository commit cells to convey "default doesn't count, only counts if you've opened a PR/issue"
- Add a Repository Type row labeling each column as Standalone or Fork; clear the redundant "Action" header label
- Mirror Own Repository values into → Upstream for the four Collaboration Channels rows
- Remove the now-misleading multi-condition tooltip from Own Repository commit cells
- Remove the redundant conditional tooltip from → Upstream commit cells
- Rewrite the Other Repository tooltip for clarity ("where (a) you aren't a collaborator, (b) you aren't a member of the org, and (c) you haven't forked it")
- Drop the comma in "Only counts, if…" → "Only counts if…"
- Apply the period rule: only full sentences end with "."; fragments like "The upstream parent repository of a fork" and "Commits on other branches…" lose the trailing period
- Replace the thin "Fork of an existing repository" tooltip with a proper definition: "A fork is a new repository that shares code and visibility settings with the original 'upstream' repository."
- Rename the "Contribution Channels" section to "Pull Request" and drop the now-redundant tooltip on "Open PR"
Copilot AI review requested due to automatic review settings April 26, 2026 18:22
@github-actions
Copy link
Copy Markdown
Contributor

Thanks for submitting a PR to the GitHub Docs project!

In order to review and merge PRs most efficiently, we require that all PRs grant maintainer edit access before we review them. For information on how to do this, see the documentation.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 26, 2026

How to review these changes 👓

Thank you for your contribution. To review these changes, choose one of the following options:

A Hubber will need to deploy your changes internally to review.

Table of review links

Note: Please update the URL for your staging server or codespace.

The table shows the files in the content directory that were changed in this pull request. This helps you review your changes on a staging server. Changes to the data directory are not included in this table.

Source Review Production What Changed
account-and-profile/how-tos/contribution-settings/troubleshooting-missing-contributions.md fpt
ghec
ghes@ 3.20 3.19 3.18 3.17 3.16 3.15 3.14
fpt
ghec
ghes@ 3.20 3.19 3.18 3.17 3.16 3.15 3.14
account-and-profile/reference/profile-contributions-reference.md fpt
ghec
ghes@ 3.20 3.19 3.18 3.17 3.16 3.15 3.14
fpt
ghec
ghes@ 3.20 3.19 3.18 3.17 3.16 3.15 3.14

Key: fpt: Free, Pro, Team; ghec: GitHub Enterprise Cloud; ghes: GitHub Enterprise Server

🤖 This comment is automatically generated.

@github-actions github-actions Bot added the triage Do not begin working on this issue until triaged by the team label Apr 26, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a “Profile contribution matrix” quick-reference table to the profile contributions reference page and links to it from the “Troubleshooting missing contributions” article to help readers quickly determine whether an action counts as a contribution.

Changes:

  • Added a new matrix table near the top of the profile contributions reference page.
  • Added an in-article reference link from the troubleshooting article to the contributions reference page.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 6 comments.

File Description
content/account-and-profile/reference/profile-contributions-reference.md Introduces the “Profile Contribution Matrix” table ahead of the existing prose rules.
content/account-and-profile/how-tos/contribution-settings/troubleshooting-missing-contributions.md Adds a cross-link to the contributions reference page for additional details.

Comment thread content/account-and-profile/reference/profile-contributions-reference.md Outdated
Comment thread content/account-and-profile/reference/profile-contributions-reference.md Outdated
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

triage Do not begin working on this issue until triaged by the team

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants