Introduce private comments when reviewing pull requests

[dawmd]

Select Topic Area

General

Body

When I review pull requests, I often make notes in form of review comments. I write down why something makes sense, why something is not necessary, etc.

Sometimes I end up posting them as part of my review: they might be useful to other reviewers and also serve me again if I re-review the changes after some time. This way, I don't need to remember the whole context or go through the same mental effort each time I look at it. However, most of the time, I remove them before submitting my feedback because I don't think others will benefit from them, so all it would do is produce unnecessary noise.

I think it would be nice if GitHub offered a feature allowing to create private comments that would only be visible to you. This way, I would keep all the advantages of having the notes, while avoiding sharing feedback of questionable value.

In my opinion, many people would benefit from this.

[MOHAMED-LAAGUILI]

1. Draft Comments

Write comments but don't submit them
❌ Problem: Lost if you accidentally submit or navigate away

2. External Notes

Use a separate tool (Notion, Obsidian, text file)
❌ Problem: Not linked to specific code lines, context switching required

3. Browser Extensions

Some extensions add private annotations to GitHub
⚠️ Tool-dependent, may break with GitHub updates

4. Use Comment Drafts Strategically

GitHub saves draft comments temporarily
❌ Problem: Not persistent, can be lost

Why This Feature Makes Sense
✅ Helps reviewers maintain context across multiple review sessions
✅ Reduces cognitive load - don't need to re-analyze everything
✅ Keeps PR discussions clean - no unnecessary noise
✅ Common in other tools (Google Docs has private comments)
Best Current Practice
Until GitHub adds this feature:

Keep a local markdown file per PR: PR-1234-notes.md
Use pending review drafts for short-term notes
Submit only actionable feedback

Bottom line: Valid feature request, no perfect workaround exists yet. External notes are your best bet for now.

[github-actions[bot]]

🕒 Discussion Activity Reminder 🕒

This Discussion has been labeled as dormant by an automated system for having no activity in the last 60 days. Please consider one the following actions:

1️⃣ Close as Out of Date: If the topic is no longer relevant, close the Discussion as out of date at the bottom of the page.

2️⃣ Provide More Information: Share additional details or context — or let the community know if you've found a solution on your own.

3️⃣ Mark a Reply as Answer: If your question has been answered by a reply, mark the most helpful reply as the solution.

Note: This dormant notification will only apply to Discussions with the Question label. To learn more, see our recent announcement.

Thank you for helping bring this Discussion to a resolution! 💬

[krishparmar22242]

Hey! I totally feel you on the 'PR noise' vs 'mental context' struggle. I looked into it, and while GitHub doesn't have a 'Private Comment' button yet, there are three 'pro' ways to handle this:
The 'Draft' Hack: When you 'Start a Review', your comments stay Pending (visible only to you). You can leave them there as notes while you work and only hit 'Submit' on the ones that actually matter to the dev.
The Pro Extension: Install 'Refined GitHub' (browser extension). It’s a game-changer it adds a 'Personal Notes' field to PRs that stays local to your browser, so you can keep notes without anyone ever seeing them.
VS Code Extension: If you review in VS Code using the GitHub Pull Requests extension, you can leave draft comments that stay local to your workspace.
Until GitHub builds this natively, Refined GitHub is probably exactly what you’re looking for! Hope that helps clear the noise!

[codey-badger]

The Pro Extension: Install 'Refined GitHub' (browser extension). It’s a game-changer it adds a 'Personal Notes' field to PRs that stays local to your browser, so you can keep notes without anyone ever seeing them.

Thanks, I will check it.

Do you know if it has something like private comments for issues too?

[github-actions[bot]]

🕒 Discussion Activity Reminder 🕒

This Discussion has been labeled as dormant by an automated system for having no activity in the last 60 days. Please consider one the following actions:

1️⃣ Close as Out of Date: If the topic is no longer relevant, close the Discussion as out of date at the bottom of the page.

2️⃣ Provide More Information: Share additional details or context — or let the community know if you've found a solution on your own.

3️⃣ Mark a Reply as Answer: If your question has been answered by a reply, mark the most helpful reply as the solution.

Note: This dormant notification will only apply to Discussions with the Question label. To learn more, see our recent announcement.

Thank you for helping bring this Discussion to a resolution! 💬