AI WORLD HQAdd helpful comments to your code with GitHub Copilot – beginner guide
A friendly step‑by‑step walkthrough that shows anyone how to get GitHub Copilot to write plain‑language comments for any line of code
This guide was written by AI. It passed automated fact and quality checks, and our editor spot-checks published guides every day.
See AI World HQ first on GoogleAdd us as a preferred source and our stories show up higher in Google’s Top Stories.Add on GoogleBy the end of this guide you'll be able to ask GitHub Copilot to write easy‑to‑read comments above any line of code, even if you've never opened a code editor before. This tutorial is for absolute beginners who want to make their scripts clearer for themselves and anyone else who reads them.
💡 Tip: tap a step’s number when you finish it — a green tick appears and your browser remembers how far you got.
- A free GitHub account (you'll sign in to VS Code with it).
- Visual Studio Code installed on your computer (Windows, macOS or Linux).
- GitHub Copilot enabled — the free tier for individual developers works, or you can upgrade to a paid plan for more usage.
- A simple code or text file you're happy to experiment with.
- About 10 minutes of uninterrupted time.
Download and install Visual Studio Code
Visit code.visualstudio.com in any web browser; you'll see a large button that usually says "Download for Windows", "Download for macOS" or "Download for Linux". Click that button, then open the installer that lands in your Downloads folder (it ends with .exe, .dmg, .deb or .rpm). The installer walks you through a few screens – just click "Next", accept the license, and press "Install". When the installer finishes, it launches VS Code, showing a window with a thin left sidebar and a blank center editor. If the button doesn't match exactly, look for a link that says "Other platforms" or "Get VS Code for …".
the VS Code icon appears on your desktop or in your applications folder and the program opens to an empty editor.
Sign in to GitHub from inside VS Code
With VS Code open, glance at the bottom‑left corner; you should see a small silhouette icon – this is the Accounts button (think of it as the door that lets VS Code meet your online identity). Click it; a tiny panel slides up offering "Sign in with GitHub". Choose that option; your default web browser opens and asks you to confirm the sign‑in. After you approve, the panel disappears and a little avatar or your initials replace the silhouette.
If you don't see the silhouette, open the menu bar, select View → Command Palette, type "Sign in" and pick the option that mentions GitHub.
your GitHub username or avatar shows up in the bottom‑left corner of VS Code.
Open a code file in the editor
Click the first icon in the left sidebar – it looks like two stacked pages and represents the Explorer (think of it as a folder browser). In the Explorer pane navigate to a folder that contains a file such as example.js or notes.txt. Single‑click the file to select it, then double‑click to open it; the file's contents fill the central editor area and a column of line numbers appears on the left. (A function is just a named bundle of instructions, like a recipe card, and a comment is a note for human readers that the computer silently ignores.) If the Explorer isn't visible, press Ctrl+Shift+E (on macOS, Cmd+Shift+E).
the file's text appears in the editor with line numbers running down the left side.
Review, edit and save the suggestion
Read the newly inserted comment aloud; if it accurately describes the code, you're finished. If the wording is off, simply click into the comment line and type a correction – Copilot does not learn from these edits, so manual tweaks are normal. To finish, save the file by pressing Ctrl+S (or Cmd+S on macOS); the dot next to the file name in the tab disappears, indicating the file is saved. If you notice the comment is still unclear, return to Step 5 and re‑phrase your prompt (for example, Summarize the tax‑calculation step in plain English).
- Typing a whole code block instead of a short prompt. GitHub Copilot works best with brief instructions like
// Explain this step. Fix: keep the trigger line under 10 words. - Pressing Escape before accepting the ghost text. The gray suggestion is the output you want; pressing Escape discards it. Fix: press Tab to accept the suggestion, then edit if needed.
- Expecting Copilot to understand very complex logic on the first try. Long or ambiguous code often yields vague comments. Fix: add more context to your prompt or break the code into smaller chunks and ask for one comment at a time.
Open any small code or text file you have, put the cursor on a blank line above a line you recognize, type // Explain what this line does, press Tab when the ghost text appears (or use the "GitHub Copilot: Explain" command if it doesn't), and then save the file. In under two minutes you'll see your first Copilot‑written comment right in the editor.
❓ Quick questions
How long does this take?
About 6 minutes — the guide has 6 steps, and you can tick each one off as you go.
Which tool do I need?
This guide uses GitHub Copilot — but the approach works very similarly in other AI assistants.
Do I need to prepare anything?
- A free GitHub account (you'll sign in to VS Code with it).
- Visual Studio Code installed on your computer (Windows, macOS or Linux).
- GitHub Copilot enabled — the free tier for individual developers works, or you can upgrade to a paid plan for more usage.
- A simple code or text file you're happy to experiment with.
- About 10 minutes of uninterrupted time.
What mistakes should I avoid?
- Typing a whole code block instead of a short prompt. GitHub Copilot works best with brief instructions like
// Explain this step. Fix: keep the trigger line under 10 words. - Pressing Escape before accepting the ghost text. The gray suggestion is the output you want; pressing Escape discards it. Fix: press Tab to accept the suggestion, then edit if needed.
- Expecting Copilot to understand very complex logic on the first try. Long or ambiguous code often yields vague comments. Fix: add more context to your prompt or break the code into smaller chunks and ask for one comment at a time.
Keep reading
✦ Generated by AI in AI World HQ's automated newsroom, written in plain language. Checked by automated fact and quality gates, and our editor spot-checks published guides every day. Spot a mistake? Use the buttons above.
📘 Prefer it in one file? First Steps with AI: The Beginner Pack (20 guides, free printable PDF)
← Back to all stories