-
Notifications
You must be signed in to change notification settings - Fork 40
Description
While reviewing the GitHub Copilot tutorial for VS Code, I’ve identified several potential improvements that can enhance clarity, flow, and usefulness — especially for students trying to use Copilot for free, facing sign-in or shortcut issues, or trying different Copilot features for the first time.
Below is a summary of issues and proposed changes:
Suggested Improvements
1. Move GitHub Student Benefits section before sign-up flow
💡 Problem: The tutorial asks users to sign up and enter billing details before introducing GitHub Student benefits.
🔧 Fix: Move the student section earlier in the page, and mention that verified students can use Copilot for free. This avoids confusion and drop-off.
2. Clarify that 2FA is required to activate Student Pack
💡 Problem: The current guide doesn’t clearly state that enabling two-factor authentication (2FA) is required to access GitHub Student Pack.
🔧 Fix: Add an “important” box:
"GitHub requires Two-Factor Authentication (2FA) to activate the Student Developer Pack and use Copilot for free."
3. Combine Copilot installation and login steps
💡 Problem: The steps for installing the Copilot extension and signing into GitHub are split across different sections, which may confuse new users.
🔧 Fix: Combine into a single heading like "Step 1: Install and Sign In" and walk through install → device code login → extension activation.
4. Split and clarify Copilot Chat, Inline Chat, and Terminal Prompts
💡 Problem: Copilot Chat, inline chat, and terminal prompts are described together, making it unclear when to use what.
🔧 Fix: Break this into 3 short subsections with brief descriptions and images for each:
- Copilot Chat (for general questions)
- Inline Chat (for code explanation/modification)
- Terminal prompts (
/explain,/fix)
5. Add a Troubleshooting section with common student issues
💡 Problem: There's no guide for what to do if Copilot doesn't work as expected.
🔧 Fix: Add a short section at the end like:
- Copilot not showing up? → Check that you're in a Java file and extension is enabled
- Shortcuts not working? → Conflicts with other extensions → Use
Keyboard Shortcutspanel- Copilot panel missing? → Try restarting VS Code or reinstalling the extension
Feedback welcome!
Would love to hear what others think about these suggestions — especially if you've used this tutorial in CS2103T/CS2113 or other SE modules.
I’m happy to submit a PR with these updates if they’re agreed upon.
Thanks!