Skip to content

Improve GitHub Copilot VS Code tutorial with student-centric enhancements #138

@arshinsikka

Description

@arshinsikka

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 Shortcuts panel
  • 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!


Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions