Skip to content

docs: Update Module 2 to use GitHub Codespaces consistently#228

Merged
WirelessLife merged 1 commit intomicrosoft:mainfrom
RayPops:fix/module2-codespaces-consistency
Feb 26, 2026
Merged

docs: Update Module 2 to use GitHub Codespaces consistently#228
WirelessLife merged 1 commit intomicrosoft:mainfrom
RayPops:fix/module2-codespaces-consistency

Conversation

@RayPops
Copy link
Contributor

@RayPops RayPops commented Feb 23, 2026

📝 Summary

This PR updates Module 2 of the "Using GitHub Copilot for Azure to Deploy to Cloud" workshop to use GitHub Codespaces consistently, aligning with the Codespaces-first approach established in Module 1.

🎯 Problem

Module 1 instructs users to open a GitHub Codespace for the workshop, but Module 2 switches to local development instructions ("Create a new folder on your local computer"). This inconsistency:

  • Creates confusion for workshop participants
  • Requires users to have local development tools installed
  • Breaks the seamless cloud-based learning experience
  • May cause issues for users on restricted corporate machines

✨ Solution

Updated Module 2 to:

  1. Continue in Codespaces - Instructions now assume users are continuing from their Module 1 Codespace
  2. Use terminal-based folder creation - Replaced GUI-based folder creation with command-line instructions
  3. Added consistent formatting - Aligned with Module 1's structure including:
    • Header metadata (Who is this for, What you'll learn, etc.)
    • Emoji section markers for visual navigation
    • Prerequisite reading section
    • Additional resources section
  4. Improved clarity - Added tips, notes, and troubleshooting guidance
  5. Fixed relative links - Updated module links to use relative paths

📋 Changes Made

Section Change
Header Added structured metadata matching Module 1 format
Prerequisites Clarified Codespace continuation requirement
Step 1 Replaced local folder creation with terminal commands
Steps 2-5 Restructured for clarity with consistent formatting
Troubleshooting Added dedicated troubleshooting section
Resources Added additional learning resources

🧪 Testing

  • Verified all terminal commands work in GitHub Codespaces
  • Confirmed all image links are accessible
  • Tested relative links to other modules
  • Validated Markdown rendering on GitHub

✅ Checklist

  • Documentation follows existing style guidelines
  • All links are valid and accessible
  • Instructions tested in GitHub Codespaces environment
  • No breaking changes to other modules
  • Consistent formatting with Module 1

First-time contributor 👋 - Feedback welcome!

- Continue Codespaces workflow from Module 1
- Replace local folder creation with terminal commands
- Add consistent formatting matching Module 1 structure
- Add troubleshooting section and additional resources
- Fix relative links to other modules
@RayPops
Copy link
Contributor Author

RayPops commented Feb 23, 2026

@microsoft-github-policy-service agree company="Microsoft"

@WirelessLife WirelessLife merged commit d393198 into microsoft:main Feb 26, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants