Skip to main content
RapidDev - Software Development Agency
github-for-non-tech

How to Comment on Code in GitHub Pull Requests

You do not need to understand code to leave useful comments on GitHub. On any Pull Request, you can leave general comments, line-specific feedback by clicking the plus icon next to any line, and formal review comments. Use @mentions to tag teammates. Non-technical reviewers catch design issues, missing features, and unclear naming that developers often miss.

What you'll learn

  • How to leave general comments on a Pull Request
  • How to leave line-specific comments on code changes
  • How to submit a formal review with approval or change requests
  • How to use @mentions to notify the right people
  • Why non-technical reviewers provide value that developers miss
Book a free consultation
4.9Clutch rating
600+Happy partners
17+Countries served
190+Team members
Beginner7 min read10 minutesAny modern web browser (Chrome, Safari, Edge, Firefox)March 2026RapidDev Engineering Team
TL;DR

You do not need to understand code to leave useful comments on GitHub. On any Pull Request, you can leave general comments, line-specific feedback by clicking the plus icon next to any line, and formal review comments. Use @mentions to tag teammates. Non-technical reviewers catch design issues, missing features, and unclear naming that developers often miss.

Why Your Feedback on Code Matters Even If You Cannot Code

Pull Requests on GitHub are where code changes get reviewed before they go live. Most people assume you need to understand code to participate, but that is not true. Non-technical team members catch things developers overlook — wrong page titles, missing features from the spec, broken links, unclear button labels, or design inconsistencies. GitHub gives you three ways to comment: general comments on the Pull Request conversation, line-specific comments on exact lines of code (even if you just recognize a text string or URL that looks wrong), and formal review comments that mark the PR as approved or needing changes. AI tools like Lovable and V0 often create Pull Requests automatically, and someone on your team should always review them before merging.

Prerequisites

  • A free GitHub account
  • Access to a repository with at least one open Pull Request
  • A modern web browser

Step-by-step guide

1

Open a Pull Request and read the description

Navigate to your repository on github.com and click the "Pull requests" tab in the top menu bar. Click on any open Pull Request to view it. The first thing you see is the Conversation tab, which shows the PR title, a description of what changed, and any existing comments. Read the description carefully — it should explain what was changed and why. If the PR was created by an AI tool like V0, the description typically lists every file that was modified and what each change does.

Expected result: You see the Pull Request conversation page with a title, description, and comment thread.

2

Leave a general comment on the Pull Request

Scroll to the bottom of the Conversation tab. You will see a text box labeled "Leave a comment." Type your feedback here — this is a good place for high-level observations like "This looks good but I do not see the newsletter signup section we discussed" or "Can you add the company logo to the footer?" You can format your text using Markdown: use **bold** for emphasis, bullet points with dashes, and paste screenshot URLs. Click the green "Comment" button to submit.

Expected result: Your comment appears in the conversation thread, and all PR participants receive a notification.

3

Navigate to the Files changed tab for line-specific feedback

Click the "Files changed" tab at the top of the Pull Request. This shows every file that was modified. Lines highlighted in green were added, and lines highlighted in red were removed. You do not need to understand the code syntax — look for things you can recognize: text strings in quotes (like page titles, button labels, URLs), file names, image references, and numbers (like prices or dimensions). These are all things a non-technical reviewer can verify.

Expected result: You see a side-by-side or unified view of all file changes with green and red highlighting.

4

Leave a comment on a specific line of code

Hover your mouse over any line in the Files changed view. A blue plus icon (+) appears to the left of the line number. Click it to open a comment box anchored to that exact line. Type your feedback — for example, if you see a line that says "Welcome to Our Websit" you could comment "Typo: should be 'Website' with an 'e' at the end." You can also click and drag the plus icon across multiple lines to comment on a range. Click the green "Start a review" button (not "Add single comment") to batch your comments into one review.

Expected result: A yellow comment badge appears next to the line, and your comment is saved as part of a pending review.

5

Submit your review with an approval or change request

After leaving all your line comments, click the green "Review changes" button in the top-right corner of the Files changed tab. A dropdown appears with three options: "Comment" (neutral feedback), "Approve" (you are satisfied with the changes), or "Request changes" (something needs to be fixed before merging). Select the appropriate option, add an optional summary comment in the text box, and click "Submit review." If you selected Request changes, the developer will see a red X on the PR indicating your feedback needs to be addressed.

Expected result: Your review appears on the Conversation tab with all your line comments grouped together and a green checkmark, yellow dot, or red X indicating your verdict.

6

Use @mentions to loop in specific teammates

In any comment box — whether on the Conversation tab or a line comment — type the @ symbol followed by a teammate's username. GitHub shows a dropdown of matching users as you type. Select the right person. For example: "@dev-sarah this pricing looks different from what we agreed on, can you check?" The mentioned person gets a direct notification. You can also mention teams if your organization has them set up, using @org-name/team-name.

Expected result: The @mentioned username becomes a clickable link in your comment, and that person receives a notification.

Complete working example

REVIEW-GUIDE.md
1# Code Review Guide for Non-Technical Reviewers
2
3## What to Look For
4
5### Text and Content
6- [ ] Page titles and headings are correct
7- [ ] Button labels match the design
8- [ ] No typos in user-facing text
9- [ ] URLs and links point to the right pages
10
11### Features
12- [ ] All requested features from the Issue are included
13- [ ] Nothing is missing from the original spec
14- [ ] No unwanted changes to existing pages
15
16### Design
17- [ ] Colors match the brand guidelines
18- [ ] Images and logos are present
19- [ ] Layout looks correct in the preview
20
21## How to Comment
22- General feedback Conversation tab comment
23- Specific line feedback Files changed tab, click + icon
24- Always use "Start a review" to batch comments
25- Use @mentions to tag the right person

Common mistakes when commenting on Code in GitHub Pull Requests

Why it's a problem: Using "Add single comment" for every line instead of "Start a review"

How to avoid: Click "Start a review" for your first line comment. This batches all feedback into one notification instead of spamming the developer with dozens of emails.

Why it's a problem: Only looking at the code and ignoring the PR description

How to avoid: Always read the description first. It tells you what was supposed to change, which helps you verify whether the changes are correct and complete.

Why it's a problem: Approving a PR without checking the Files changed tab

How to avoid: Always click Files changed and scan for recognizable elements like text strings, URLs, and image paths. You might catch a typo or wrong link that the developer missed.

Why it's a problem: Leaving vague comments like "this looks wrong"

How to avoid: Be specific: "The price on line 42 says $29 but our pricing page says $25" gives the developer exactly what they need to fix.

Best practices

  • Read the Pull Request description before looking at code changes
  • Use "Start a review" to batch all line comments into a single notification
  • Focus on things you can verify: text, URLs, image references, feature completeness
  • Attach screenshots by dragging images into the comment box
  • Be specific in your feedback — reference line numbers and exact text
  • Use @mentions to route questions to the right person
  • Mark your review as "Approve" or "Request changes" to make your verdict clear
  • Review AI-generated Pull Requests from tools like Lovable and V0 just as carefully as human-written ones

Still stuck?

Copy one of these prompts to get a personalized, step-by-step explanation.

ChatGPT Prompt

I'm a non-technical founder reviewing a Pull Request on GitHub. Give me a checklist of things I can look for without understanding the code, focusing on content, features, and design elements.

Frequently asked questions

Can I review code if I do not understand programming?

Absolutely. You can check for typos in user-facing text, verify that URLs are correct, confirm that requested features are included, and ensure the PR description matches the actual changes. These are valuable contributions that developers often overlook.

What is the difference between a comment, approval, and change request?

A comment is neutral feedback with no verdict. An approval means you are satisfied and the PR can be merged. A change request means something needs to be fixed first — it blocks merging until the issues are addressed or the review is dismissed.

Will the developer see my comments immediately?

If you use "Start a review," your comments are only visible to you until you submit the review. If you use "Add single comment," each comment is posted and notified immediately.

Can I edit or delete a comment after posting it?

Yes. Click the three-dot menu icon in the top-right corner of your comment and select "Edit" or "Delete." Edited comments show a small "edited" label so others know it was changed.

Should I review Pull Requests created by AI tools like Lovable?

Yes, always. AI tools generate code quickly but can make mistakes — wrong text, missing features, or unintended changes. A non-technical reviewer checking the description and visible text is an important quality control step.

Can RapidDev help us set up a code review process?

Yes. RapidDev helps teams establish review workflows, create review checklists for non-technical reviewers, and configure branch protection rules so Pull Requests cannot be merged without approval.

How do I review changes if the Pull Request has hundreds of files?

Use the file filter in the Files changed tab to search for specific file types or names. Focus on files you recognize — like pages, components with text content, or configuration files with URLs and settings.

RapidDev

Talk to an Expert

Our team has built 600+ apps. Get personalized help with your project.

Book a free consultation

Need help with your project?

Our experts have built 600+ apps and can accelerate your development. Book a free consultation — no strings attached.

Book a free consultation

We put the rapid in RapidDev

Need a dedicated strategic tech and growth partner? Discover what RapidDev can do for your business! Book a call with our team to schedule a free, no-obligation consultation. We'll discuss your project and provide a custom quote at no cost.