diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-01-github-account/tutorial.md b/src/modules/wds/course/module-02-installation-setup/lesson-01-github-account/tutorial.md deleted file mode 100644 index 18a32233..00000000 --- a/src/modules/wds/course/module-02-installation-setup/lesson-01-github-account/tutorial.md +++ /dev/null @@ -1,94 +0,0 @@ -# Lesson 01: Create Your GitHub Account - -**Get your professional GitHub account set up** - ---- - -## What You'll Do - -- Create GitHub account -- Choose professional username -- Verify your email -- Log in successfully - -**Time:** 5-10 minutes - ---- - -## What is GitHub? - -Think of GitHub as: -- **Professional cloud storage** for your project files -- **Time machine** - every change saved, can go back to any version -- **Collaboration tool** - work with others seamlessly - -**For designers:** GitHub is where your WDS specifications will live, backed up and version-controlled. - ---- - -## Step 1: Sign Up - -1. Go to **https://github.com** -2. Click the green **"Sign up"** button (top right) -3. Enter your email address -4. Create a password (make it strong!) -5. Choose a username - ---- - -## Choosing Your Username - -**Username Tips:** - -✅ **Professional** - You might share this with clients -✅ **Simple** - Easy to remember and spell -✅ **Memorable** - Represents you or your work - -**Good Examples:** -- `john-designer` -- `sarahux` -- `mike-creates` -- `[yourname]-design` - -**Avoid:** -- `xXcooldesigner420Xx` (not professional) -- `temporary12345` (not memorable) -- Very long complicated names - ---- - -## Step 2: Verify Account - -6. Verify you're human (solve the puzzle) -7. Check your email inbox -8. Click the verification link from GitHub -9. You'll be redirected back to GitHub - -**✅ Checkpoint:** You can log in to GitHub! - ---- - -## Troubleshooting - -**Issue:** Didn't receive verification email -**Solution:** Check spam folder, or click "Resend verification email" - -**Issue:** Username already taken -**Solution:** Try variations with hyphens or numbers (`john-ux-designer`, `sarah-designs-2`) - -**Issue:** Password requirements -**Solution:** Use at least 8 characters, mix of letters and numbers - ---- - -## What's Next? - -Now that you have a GitHub account, you're ready to create your first repository! - -**[Continue to Lesson 02: Create Repository →](../lesson-02-create-repository/tutorial.md)** - ---- - -*Part of Module 02: Installation & Setup* -*[← Back to Module Overview](../module-02-overview.md)* - diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-01-github-and-ide-setup/checklist.md b/src/modules/wds/course/module-02-installation-setup/lesson-01-github-and-ide-setup/checklist.md new file mode 100644 index 00000000..5c256ed0 --- /dev/null +++ b/src/modules/wds/course/module-02-installation-setup/lesson-01-github-and-ide-setup/checklist.md @@ -0,0 +1,87 @@ +# Lesson 01: GitHub & IDE Setup - Quick Checklist + +**⏱️ 25-30 minutes** + +--- + +## Part 1: GitHub Account + +- [ ] Go to **https://github.com** +- [ ] Click **"Sign up"** +- [ ] Enter email, password, username (professional: `yourname-designer`) +- [ ] Verify email +- [ ] ✅ Log in successful + +--- + +## Part 2: Create or Join Repository + +### Choose Your Scenario + +- [ ] **A:** Starting new project → Continue below +- [ ] **B:** Joining existing → Skip to "Join Existing" +- [ ] **C:** Just learning → Skip to Part 3 + +### Create New Repository + +- [ ] Click profile icon → **"Your repositories"** → **"New"** + +**Decide: Single or Separate?** + +- [ ] **Single repo:** `my-project` (specs + code together, for small teams) +- [ ] **Separate repo:** `my-project-specs` (specs only, for corporate/many devs) + +- [ ] Name: `_____________` (lowercase-with-hyphens) +- [ ] Description: One-liner about project +- [ ] Public or Private +- [ ] ☑️ Check "Initialize with README" +- [ ] Click **"Create repository"** +- [ ] ✅ Repository created + +### Join Existing Repository + +- [ ] Ask owner for access (see full lesson for email template) +- [ ] Accept invitation from email +- [ ] Check repo structure (name, folders) +- [ ] ✅ Access granted + +--- + +## Part 3: IDE Installation + +### Choose & Download + +- [ ] **Cursor** (recommended) → https://cursor.sh +- [ ] **VS Code** (alternative) → https://code.visualstudio.com +- [ ] Download installer + +### Install + +- [ ] **Windows:** Run `.exe`, click through +- [ ] **Mac:** Drag to Applications, open +- [ ] **Linux:** Follow distro instructions + +### First Launch + +- [ ] Choose theme (Light/Dark) +- [ ] Sign in with GitHub → Yes! +- [ ] Install recommended extensions → Yes +- [ ] ✅ IDE open + +### Verify Terminal + +- [ ] Press **Ctrl+`** (Win/Linux) or **Cmd+`** (Mac) +- [ ] ✅ Terminal panel appears + +--- + +## Next Step + +✅ GitHub & IDE ready! + +**[→ Lesson 02: Git Configuration](../lesson-02-git-setup/checklist.md)** + +--- + +**Need more detail?** See [full lesson explanation](lesson.md) + diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-01-github-and-ide-setup/lesson.md b/src/modules/wds/course/module-02-installation-setup/lesson-01-github-and-ide-setup/lesson.md new file mode 100644 index 00000000..55422288 --- /dev/null +++ b/src/modules/wds/course/module-02-installation-setup/lesson-01-github-and-ide-setup/lesson.md @@ -0,0 +1,203 @@ +# Lesson 01: GitHub & IDE Setup + +**Get your development environment ready** + +--- + +## What You'll Do + +- Create GitHub account +- Create or join repository +- Install IDE (Cursor or VS Code) +- Verify everything works + +**Time:** 25-30 minutes + +--- + +## Part 1: GitHub Setup + +### What is GitHub? + +Professional cloud storage + time machine for your project files. Every change is saved, you can go back to any version, and you can work with others. + +### Step 1: Create GitHub Account + +1. Go to **https://github.com** +2. Click **"Sign up"** (top right) +3. Enter email, password, username + +**Username Tips:** +- Professional: `john-designer`, `sarahux`, `mike-creates` +- You might share this with clients + +4. Verify email +5. Log in + +**✅ Checkpoint:** You can log in to GitHub + +--- + +### Step 2: Choose Your Scenario + +**Scenario A: Starting a New Project** → Continue to Step 3 +**Scenario B: Joining Existing Project** → Skip to Step 6 +**Scenario C: Just Learning WDS** → Skip to Part 2 + +--- + +### Step 3: Create Repository (Scenario A) + +1. Click profile icon → **"Your repositories"** → **"New"** + +### Step 4: Decide Repository Structure + +**IMPORTANT: Your naming choice determines your structure!** + +#### Single Repository + +**Name:** `my-project` (e.g., `dog-walker-app`) + +``` +my-project/ +├── docs/ ← WDS specifications +└── src/ ← Code +``` + +**Use when:** +- Small team, building yourself +- Simple communication +- Rapid iteration + +#### Separate Specifications Repository + +**Name:** `my-project-specs` (e.g., `dog-walker-app-specs`) + +``` +my-project-specs/ ← Specifications only +my-project/ ← Separate code repo +``` + +**Use when:** +- Corporate environment +- Many developers +- Clear handoff needed + +### Step 5: Create Repository + +- **Name:** `____________` (lowercase-with-hyphens) +- **Description:** One-liner about project +- **Public** (portfolio) or **Private** (client work) +- ☑️ **Check "Initialize with README"** +- Click **"Create repository"** + +**✅ Checkpoint:** Repository created + +--- + +### Step 6: Join Existing Repository (Scenario B) + +**Email template:** + +``` +Hi [Name], + +I'd like to contribute to [project-name] using WDS methodology. +Could you add me as a collaborator? + +My GitHub username: [your-username] + +Thank you! +``` + +**Then:** +1. Accept invitation from email +2. Check repo name (ends in `-specs`? Separate repo) +3. Browse structure (has `docs/`? WDS already!) + +**✅ Checkpoint:** Access granted + +--- + +## Part 2: IDE Installation + +### What is an IDE? + +Your workspace for creating specifications. Like Microsoft Word, but for design files. + +### Step 1: Choose Your IDE + +**Cursor (Recommended)** +- Built for AI assistance +- Perfect for WDS +- Download: https://cursor.sh + +**VS Code (Alternative)** +- Industry standard +- Works great too +- Download: https://code.visualstudio.com + +**For beginners:** Choose Cursor + +--- + +### Step 2: Install + +**Windows:** +1. Run `.exe` file +2. Click through installer +3. Use defaults + +**Mac:** +1. Open download +2. Drag to Applications +3. Open from Applications + +**Linux:** +Follow distro instructions + +--- + +### Step 3: First Launch + +1. Choose theme (Light/Dark) +2. **Sign in with GitHub** → Yes! +3. Install recommended extensions → Yes + +**✅ Checkpoint:** IDE open and ready + +--- + +### Step 4: Verify Terminal + +Press **Ctrl+`** (Win/Linux) or **Cmd+`** (Mac) + +**✅ Checkpoint:** Terminal panel appears + +--- + +## Troubleshooting + +**GitHub Issues:** +- **Verification email missing** → Check spam +- **Username taken** → Try `yourname-designer-2` +- **Repository name taken** → Add your username + +**IDE Issues:** +- **Can't find download** → Check Downloads folder +- **Mac "unidentified developer"** → Right-click → Open +- **Terminal won't open** → View menu → Terminal → New Terminal + +--- + +## What's Next? + +GitHub account, repository, and IDE are ready! Now let's configure Git. + +**[Continue to Lesson 02: Git Configuration →](../lesson-02-git-setup/lesson.md)** + +--- + +*Part of Module 02: Installation & Setup* +*[← Back to Module Overview](../module-02-overview.md)* + diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-01-setting-up-github/checklist.md b/src/modules/wds/course/module-02-installation-setup/lesson-01-setting-up-github/checklist.md deleted file mode 100644 index 32383bda..00000000 --- a/src/modules/wds/course/module-02-installation-setup/lesson-01-setting-up-github/checklist.md +++ /dev/null @@ -1,70 +0,0 @@ -# Lesson 01: GitHub Setup - Quick Checklist - -**⏱️ 15-20 minutes** - ---- - -## Create GitHub Account - -- [ ] Go to **https://github.com** -- [ ] Click **"Sign up"** -- [ ] Enter email, password, username (professional: `yourname-designer`) -- [ ] Verify email -- [ ] ✅ Log in successful - ---- - -## Choose Your Scenario - -- [ ] **A:** Starting new project → Continue below -- [ ] **B:** Joining existing → Skip to "Join Existing" section -- [ ] **C:** Just learning → Skip to [Lesson 02](../lesson-02-install-ide/checklist.md) - ---- - -## Create New Repository - -- [ ] Click profile icon → **"Your repositories"** → **"New"** - -### Decide: Single or Separate? - -**Single repo (specs + code together):** -- [ ] Name: `my-project` (e.g., `dog-walker-app`) -- [ ] For: Small team, building yourself, simple communication - -**Separate specs repo (specs only):** -- [ ] Name: `my-project-specs` (e.g., `dog-walker-app-specs`) -- [ ] For: Corporate, many developers, clear handoff - -### Repository Settings - -- [ ] Name: `_____________` (lowercase-with-hyphens) -- [ ] Description: One-liner about project -- [ ] Public or Private -- [ ] ☑️ **Check "Initialize with README"** -- [ ] Click **"Create repository"** -- [ ] ✅ Repository created - ---- - -## Join Existing Repository - -- [ ] Ask owner for access (email template in lesson.md) -- [ ] Check email for GitHub invitation -- [ ] Click **"Accept invitation"** -- [ ] Check repo name (ends in `-specs`? Separate repo) -- [ ] Browse repo structure (has `docs/`? WDS already!) -- [ ] ✅ Access granted - ---- - -## Next Step - -✅ GitHub setup complete! - -**[→ Lesson 02: IDE Installation](../lesson-02-install-ide/checklist.md)** - ---- - -**Need more detail?** See [full lesson explanation](lesson.md) - diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-01-setting-up-github/lesson.md b/src/modules/wds/course/module-02-installation-setup/lesson-01-setting-up-github/lesson.md deleted file mode 100644 index 93546ae7..00000000 --- a/src/modules/wds/course/module-02-installation-setup/lesson-01-setting-up-github/lesson.md +++ /dev/null @@ -1,251 +0,0 @@ -# Lesson 01: GitHub Setup - -**Create your GitHub account and project repository** - ---- - -## What You'll Do - -- Create GitHub account -- Choose professional username -- Create or join a project repository -- Decide on repository structure (single vs separate) - -**Time:** 15-20 minutes - ---- - -## Step 1: Create Your GitHub Account - -### What is GitHub? - -Think of GitHub as a professional cloud storage + time machine for your project files. Every change is saved, you can go back to any version, and you can work with others. - -### 1.1 Sign Up - -1. Go to **https://github.com** -2. Click the green **"Sign up"** button (top right) -3. Enter your email address -4. Create a password (make it strong!) -5. Choose a username - -**Username Tips:** -- Professional (you might share this with clients) -- Simple and memorable -- Examples: `john-designer`, `sarahux`, `mike-creates` - -6. Verify you're human (solve the puzzle) -7. Check your email and click the verification link - -**✅ Checkpoint:** You can log in to GitHub - ---- - -## Step 2: Create Your Project Repository - -### What is a Repository? - -A folder that GitHub tracks. Every change you make is saved, and you can always go back. - -### 2.1 Three Scenarios - -**Before creating a repository, determine which scenario applies to you:** - -**Scenario A: Starting a New Project** (Continue to 2.2 below) -- You're starting fresh -- No existing repository -- You control the setup - -**Scenario B: Joining an Existing Project** (Skip to 2.6 below) -- Team project already exists -- Client has existing repository -- Contributing to ongoing work - -**Scenario C: Using WDS as a Reference Only** (Skip this lesson) -- You're just learning WDS methodology -- Not starting a project yet -- **→ [Continue to Lesson 02: IDE Installation](../lesson-02-install-ide/tutorial.md)** - -**Most beginners: Use Scenario A (start new project)** - ---- - -## Scenario A: Create New Repository - -### 2.2 Navigate to Repositories - -1. After logging in, click your **profile icon** (top right) -2. Click **"Your repositories"** -3. Click the green **"New"** button - -### 2.3 Repository Settings - -**IMPORTANT: Your naming choice determines your structure!** - -#### Single Repo or Separate Specs Repo? - -**Option A: Single Repository** - -**Name it simply:** -- `dog-walker-app` -- `recipe-platform` -- `fitness-tracker` - -**Structure:** -``` -dog-walker-app/ -├── docs/ ← Your WDS specifications -└── src/ ← Code -``` - -**Use when:** -- ✅ You're close to the development team -- ✅ You want simple, direct communication -- ✅ You're building the whole project yourself -- ✅ Working closely with other designers -- ✅ Small team with full ownership -- ✅ Rapid iteration and feedback - -**Option B: Separate Specifications Repository** - -**Name with `-specs` suffix:** -- `dog-walker-app-specs` -- `recipe-platform-specs` -- `fitness-tracker-specs` - -**Structure:** -``` -dog-walker-app-specs/ ← This repo (specifications only) -dog-walker-app/ ← Separate code repo -``` - -**Use when:** -- ✅ Corporate or enterprise environment -- ✅ Specifications serve multiple products/platforms -- ✅ Development team has many developers -- ✅ Extensive or complex codebase -- ✅ Clear handoff boundaries needed -- ✅ Design and dev have separate workflows - -**For this tutorial:** -- Beginners: Use **Option A** (single repo like `dog-walker-app`) -- Corporate/Enterprise: Use **Option B** (separate like `dog-walker-app-specs`) - -**Choose your name now based on your situation!** - ---- - -**Repository Name:** -- Use lowercase with hyphens -- Descriptive and specific -- Examples: `dog-walker-app` OR `dog-walker-app-specs` - -**Description:** -- Short one-liner about your project -- Example: "UX specifications for Dog Week family coordination app" - -**Public vs Private:** -- **Public:** Anyone can see (good for portfolio projects) -- **Private:** Only you and invited collaborators (good for client work) - -**Initialize with README:** -- ☑️ **Check this box!** It creates a starter file - -**DO NOT** add .gitignore or license yet (we'll do this later) - -### 2.4 Create Repository - -Click the green **"Create repository"** button - -**✅ Checkpoint:** You see your new repository with a README file - -**Remember your choice:** -- Single repo (`my-project`)? Specs and code together -- Separate repo (`my-project-specs`)? You'll create a second repo for code later - -**[Continue to Lesson 02: IDE Installation →](../lesson-02-install-ide/tutorial.md)** - ---- - -## Scenario B: Joining Existing Repository - -### 2.6 Request Repository Access - -**If you're joining a team project or client repository:** - -**Ask the repository owner or team lead:** - -``` -Hi [Name], - -I'd like to contribute to [project-name] using WDS methodology. -Could you add me as a collaborator to the repository? - -My GitHub username: [your-username] - -Thank you! -``` - -**They will:** -1. Go to repository settings -2. Click "Collaborators" -3. Add your GitHub username -4. You'll receive an email invitation - -### 2.7 Accept the Invitation - -1. Check your email for GitHub invitation -2. Click **"Accept invitation"** -3. Or go to the repository URL directly -4. You'll see an invitation banner → Click **"Accept"** - -### 2.8 Understand the Existing Structure - -**Before cloning, check what structure they're using:** - -Look at the repository name: -- `project-name` → Likely single repo (specs + code together) -- `project-name-specs` → Separate specs repo (code elsewhere) - -Browse the repository: -- Has `docs/` folder? → Probably already using WDS! -- Has `src/` or `app/` folder? → Code lives here too (single repo) -- Only documentation? → Separate specs repo - -**Ask the team lead if unsure!** - -**✅ Checkpoint:** Invitation accepted, you understand the structure - -**[Continue to Lesson 02: IDE Installation →](../lesson-02-install-ide/tutorial.md)** - ---- - -## Troubleshooting - -**Issue:** Didn't receive verification email -**Solution:** Check spam folder, or click "Resend verification email" - -**Issue:** Username already taken -**Solution:** Try variations with hyphens or numbers (`john-ux-2`, `sarah-designs`) - -**Issue:** Repository name already taken -**Solution:** Add your username: `yourname-project-name` - -**Issue:** Don't know which structure to use -**Solution:** Ask your team lead, or use single repo (simpler for beginners) - -**Issue:** Invitation expired -**Solution:** Ask repository owner to resend invitation - ---- - -## What's Next? - -GitHub is set up and your repository is ready! Now let's install your IDE. - -**[Continue to Lesson 02: IDE Installation →](../lesson-02-install-ide/tutorial.md)** - ---- - -*Part of Module 02: Installation & Setup* -*[← Back to Module Overview](../module-02-overview.md)* diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-02-create-repository/tutorial.md b/src/modules/wds/course/module-02-installation-setup/lesson-02-create-repository/tutorial.md deleted file mode 100644 index 1814779c..00000000 --- a/src/modules/wds/course/module-02-installation-setup/lesson-02-create-repository/tutorial.md +++ /dev/null @@ -1,223 +0,0 @@ -# Lesson 02: Create Your Project Repository - -**Set up your project repository or join an existing one** - ---- - -## What You'll Do - -- Understand three common scenarios -- Create a new repository (Scenario A) -- OR join an existing project (Scenario B) -- Decide: Single repo or separate specs repo -- Name your repository correctly - -**Time:** 10-15 minutes - ---- - -## Three Scenarios - -**Before creating a repository, determine which applies to you:** - -### Scenario A: Starting a New Project -- You're starting fresh -- No existing repository -- You control the setup -- **→ Continue reading below** - -### Scenario B: Joining an Existing Project -- Team project already exists -- Client has existing repository -- Contributing to ongoing work -- **→ Skip to "Joining Existing Repository" section below** - -### Scenario C: Just Learning WDS -- You're just learning WDS methodology -- Not starting a project yet -- Following along with tutorial -- **→ Skip to [Lesson 03: Install IDE](../lesson-03-install-ide/tutorial.md)** - -**Most beginners: Use Scenario A** - ---- - -## Scenario A: Create New Repository - -### Step 1: Navigate to Repositories - -1. Log in to GitHub -2. Click your **profile icon** (top right) -3. Click **"Your repositories"** -4. Click the green **"New"** button - ---- - -### Step 2: Choose Your Repository Structure - -**IMPORTANT: Your naming choice determines your structure!** - -#### Option A: Single Repository - -**Name it simply:** -- `dog-walker-app` -- `recipe-platform` -- `fitness-tracker` - -**Structure:** -``` -dog-walker-app/ -├── docs/ ← Your WDS specifications -└── src/ ← Code -``` - -**Use when:** -- ✅ You're close to the development team -- ✅ You want simple, direct communication -- ✅ You're building the whole project yourself -- ✅ Working closely with other designers -- ✅ Small team with full ownership -- ✅ Rapid iteration and feedback - ---- - -#### Option B: Separate Specifications Repository - -**Name with `-specs` suffix:** -- `dog-walker-app-specs` -- `recipe-platform-specs` -- `fitness-tracker-specs` - -**Structure:** -``` -dog-walker-app-specs/ ← This repo (specifications only) -dog-walker-app/ ← Separate code repo (create later) -``` - -**Use when:** -- ✅ Corporate or enterprise environment -- ✅ Specifications serve multiple products/platforms -- ✅ Development team has many developers -- ✅ Extensive or complex codebase -- ✅ Clear handoff boundaries needed -- ✅ Design and dev have separate workflows - ---- - -### Step 3: Repository Settings - -**Repository Name:** -- Use lowercase with hyphens -- Descriptive and specific -- Examples: `dog-walker-app` OR `dog-walker-app-specs` - -**Description:** -- Short one-liner about your project -- Example: "UX specifications for Dog Week family coordination app" - -**Public vs Private:** -- **Public:** Anyone can see (good for portfolio projects) -- **Private:** Only you and invited collaborators (good for client work) - -**Initialize with README:** -- ☑️ **Check this box!** It creates a starter file - -**DO NOT** add .gitignore or license yet (we'll do this later) - ---- - -### Step 4: Create Repository - -Click the green **"Create repository"** button - -**✅ Checkpoint:** You see your new repository with a README file - -**Remember your choice:** -- Single repo (`my-project`)? Specs and code together -- Separate repo (`my-project-specs`)? You'll create a second repo for code later - -**[Continue to Lesson 03: Install IDE →](../lesson-03-install-ide/tutorial.md)** - ---- - -## Scenario B: Joining Existing Repository - -**If you're joining a team project or client repository:** - -### Step 1: Request Repository Access - -**Email template for repository owner or team lead:** - -``` -Hi [Name], - -I'd like to contribute to [project-name] using WDS methodology. -Could you add me as a collaborator to the repository? - -My GitHub username: [your-username] - -Thank you! -``` - -**They will:** -1. Go to repository settings -2. Click "Collaborators" -3. Add your GitHub username -4. You'll receive an email invitation - ---- - -### Step 2: Accept the Invitation - -1. Check your email for GitHub invitation -2. Click **"Accept invitation"** -3. Or go to the repository URL directly -4. You'll see an invitation banner → Click **"Accept"** - ---- - -### Step 3: Understand the Existing Structure - -**Before cloning, check what structure they're using:** - -**Look at the repository name:** -- `project-name` → Likely single repo (specs + code together) -- `project-name-specs` → Separate specs repo (code elsewhere) - -**Browse the repository:** -- Has `docs/` folder? → Probably already using WDS! -- Has `src/` or `app/` folder? → Code lives here too (single repo) -- Only documentation? → Separate specs repo - -**When in doubt:** Ask the team lead! - -**✅ Checkpoint:** Invitation accepted, you understand the structure - -**[Continue to Lesson 03: Install IDE →](../lesson-03-install-ide/tutorial.md)** - ---- - -## Troubleshooting - -**Issue:** Repository name already taken -**Solution:** Add your username or team name: `yourname-project-name` - -**Issue:** Don't know which structure to use -**Solution:** Ask your team lead, or use single repo (simpler) - -**Issue:** Invitation expired -**Solution:** Ask repository owner to resend invitation - ---- - -## What's Next? - -Now that your repository is set up, it's time to install your IDE! - -**[Continue to Lesson 03: Install IDE →](../lesson-03-install-ide/tutorial.md)** - ---- - -*Part of Module 02: Installation & Setup* -*[← Back to Module Overview](../module-02-overview.md)* - diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-03-git-setup/checklist.md b/src/modules/wds/course/module-02-installation-setup/lesson-02-git-configuration/checklist.md similarity index 54% rename from src/modules/wds/course/module-02-installation-setup/lesson-03-git-setup/checklist.md rename to src/modules/wds/course/module-02-installation-setup/lesson-02-git-configuration/checklist.md index 3ce97cd6..a069c50d 100644 --- a/src/modules/wds/course/module-02-installation-setup/lesson-03-git-setup/checklist.md +++ b/src/modules/wds/course/module-02-installation-setup/lesson-02-git-configuration/checklist.md @@ -1,4 +1,4 @@ -# Lesson 03: Git Configuration - Quick Checklist +# Lesson 02: Git Configuration - Quick Checklist **⏱️ 5 minutes** @@ -6,9 +6,8 @@ ## Choose Approach -- [ ] **Option 1:** Let Cursor handle Git (easiest - do nothing now!) +- [ ] **Option 1:** Let Cursor handle Git (do nothing - easiest!) - [ ] **Option 2:** Use GitHub Desktop (visual) → https://desktop.github.com -- [ ] **Option 3:** Check terminal: `git --version` --- @@ -17,13 +16,13 @@ - [ ] Download from https://desktop.github.com - [ ] Install - [ ] Sign in with GitHub account -- [ ] ✅ Ready to clone visually +- [ ] ✅ Ready for visual cloning --- -## Recap Your Repo Structure +## Recap Repository Structure -You decided in Lesson 01: +From Lesson 01: - [ ] Single repo: `my-project` (specs + code together) - [ ] Separate repo: `my-project-specs` (specs only) @@ -31,9 +30,9 @@ You decided in Lesson 01: ## Next Step -✅ Git configured! +✅ Git ready! -**[→ Lesson 04: Repository Cloning & WDS Integration](../lesson-04-clone-and-wds/checklist.md)** +**[→ Lesson 03: Repository Cloning & WDS Integration](../lesson-03-clone-and-wds/checklist.md)** --- diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-02-git-configuration/lesson.md b/src/modules/wds/course/module-02-installation-setup/lesson-02-git-configuration/lesson.md new file mode 100644 index 00000000..658f60f8 --- /dev/null +++ b/src/modules/wds/course/module-02-installation-setup/lesson-02-git-configuration/lesson.md @@ -0,0 +1,88 @@ +# Lesson 02: Git Configuration + +**Let your IDE handle Git automatically** + +--- + +## What You'll Do + +- Understand what Git does +- Let Cursor install Git automatically +- OR use GitHub Desktop (visual alternative) + +**Time:** 5 minutes + +--- + +## What is Git? + +**Git** syncs your computer with GitHub. Good news: You don't need to install it manually! + +--- + +## Option 1: Let Cursor Handle It (Recommended) + +**Do nothing now!** + +When you clone in Lesson 03, Cursor will: +1. Check if Git is installed +2. Prompt "Install Git?" if needed +3. You click "Install" +4. Done! + +**This is easiest for beginners.** + +--- + +## Option 2: GitHub Desktop (Visual Alternative) + +**For designers who prefer visual tools:** + +### Why GitHub Desktop? + +- No terminal commands +- Visual interface +- See changes graphically +- Many professionals use it + +### Install + +1. Download: https://desktop.github.com +2. Install (standard installer) +3. Sign in with GitHub account +4. Use it to clone repositories (Lesson 03) +5. Use Cursor to edit specifications + +**This is a valid professional workflow!** + +--- + +## Recap: Your Repository Structure + +**You decided in Lesson 01:** + +**Single repo (`my-project`):** +``` +my-project/ +├── docs/ ← Specs +└── src/ ← Code +``` + +**Separate repo (`my-project-specs`):** +``` +my-project-specs/ ← Specs only +``` + +--- + +## What's Next? + +Git will be ready when you need it! Now clone your repository and add WDS. + +**[Continue to Lesson 03: Repository Cloning & WDS Integration →](../lesson-03-clone-and-wds/lesson.md)** + +--- + +*Part of Module 02: Installation & Setup* +*[← Back to Module Overview](../module-02-overview.md)* + diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-02-install-ide/checklist.md b/src/modules/wds/course/module-02-installation-setup/lesson-02-install-ide/checklist.md deleted file mode 100644 index ccf32525..00000000 --- a/src/modules/wds/course/module-02-installation-setup/lesson-02-install-ide/checklist.md +++ /dev/null @@ -1,48 +0,0 @@ -# Lesson 02: IDE Installation - Quick Checklist - -**⏱️ 10 minutes** - ---- - -## Choose IDE - -- [ ] **Cursor** (recommended for AI work) → https://cursor.sh -- [ ] **VS Code** (alternative) → https://code.visualstudio.com - ---- - -## Install - -- [ ] Download installer -- [ ] **Windows:** Run `.exe`, click through -- [ ] **Mac:** Drag to Applications, open -- [ ] **Linux:** Follow distro instructions - ---- - -## First Launch - -- [ ] Choose theme (Light/Dark) -- [ ] **Sign in with GitHub** → Yes! -- [ ] Install recommended extensions → Yes -- [ ] ✅ IDE open - ---- - -## Verify Terminal - -- [ ] Press **Ctrl+`** (Win/Linux) or **Cmd+`** (Mac) -- [ ] ✅ Terminal panel appears - ---- - -## Next Step - -✅ IDE installed! - -**[→ Lesson 03: Git Configuration](../lesson-03-git-setup/checklist.md)** - ---- - -**Need more detail?** See [full lesson explanation](lesson.md) - diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-02-install-ide/lesson.md b/src/modules/wds/course/module-02-installation-setup/lesson-02-install-ide/lesson.md deleted file mode 100644 index 283a7038..00000000 --- a/src/modules/wds/course/module-02-installation-setup/lesson-02-install-ide/lesson.md +++ /dev/null @@ -1,149 +0,0 @@ -# Lesson 02: IDE Installation - -**Get your workspace set up with Cursor or VS Code** - ---- - -## What You'll Do - -- Choose between Cursor and VS Code -- Download and install your IDE -- Complete first-launch setup -- Sign in with GitHub - -**Time:** 10 minutes - ---- - -## What is an IDE? - -**IDE = Integrated Development Environment** - -Your workspace for creating specifications. Like Microsoft Word, but for design files. - ---- - -## Step 1: Choose Your IDE - -### Cursor (Recommended) - -**Why Cursor:** -- Built for AI assistance -- Modern interface -- Perfect for WDS -- **Download:** https://cursor.sh - -### VS Code (Alternative) - -**Why VS Code:** -- Industry standard -- More extensions -- Works great with WDS too -- **Download:** https://code.visualstudio.com - -**For beginners:** Choose Cursor. It's designed for AI-augmented work. - ---- - -## Step 2: Install Cursor - -### 2.1 Download - -1. Go to **https://cursor.sh** -2. Click download button for your platform -3. Wait for download - -### 2.2 Install - -**Windows:** -1. Double-click the `.exe` file -2. Follow installer prompts -3. Use default settings -4. Click "Finish" - -**Mac:** -1. Open the download -2. Drag Cursor to Applications folder -3. Open Applications folder -4. Double-click Cursor to launch - -**Linux:** -1. Follow installation instructions for your distribution - ---- - -## Step 3: First Launch Setup - -1. Open Cursor for the first time -2. Choose your theme (Light or Dark - you can change this later) - -### 3.1 Setup Wizard - -Cursor will ask you a few questions: - -- **"Import settings from VS Code?"** → Skip (unless you already use VS Code) -- **"Sign in with GitHub?"** → Yes! (makes cloning easier) -- **"Install recommended extensions?"** → Yes - -**✅ Checkpoint:** Cursor is open and ready - ---- - -## Install VS Code (Alternative) - -If you chose VS Code instead: - -### Download and Install - -1. Go to **https://code.visualstudio.com** -2. Download for your platform -3. Follow same installation steps as Cursor above -4. Complete first-launch setup -5. Sign in with GitHub when prompted - ---- - -## Verify Installation - -### Open the Terminal - -This is important for upcoming lessons! - -**Windows / Linux:** -- Press **Ctrl + `** (backtick key, usually above Tab) - -**Mac:** -- Press **Cmd + `** (backtick key) - -**You should see a terminal panel appear at the bottom!** - -**✅ Checkpoint:** Terminal opens successfully - ---- - -## Troubleshooting - -**Issue:** Can't find download -**Solution:** Check your Downloads folder - -**Issue:** Mac says "Cannot open - unidentified developer" -**Solution:** Right-click Cursor → Click "Open" → Click "Open" again - -**Issue:** Terminal won't open -**Solution:** View menu → Terminal → New Terminal - -**Issue:** GitHub sign-in fails -**Solution:** You can skip for now, we'll handle it later - ---- - -## What's Next? - -Your IDE is ready! Now let's understand Git and how your IDE handles it automatically. - -**[Continue to Lesson 03: Git Configuration →](../lesson-03-git-setup/tutorial.md)** - ---- - -*Part of Module 02: Installation & Setup* -*[← Back to Module Overview](../module-02-overview.md)* diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-04-clone-and-wds/checklist.md b/src/modules/wds/course/module-02-installation-setup/lesson-03-clone-and-wds/checklist.md similarity index 100% rename from src/modules/wds/course/module-02-installation-setup/lesson-04-clone-and-wds/checklist.md rename to src/modules/wds/course/module-02-installation-setup/lesson-03-clone-and-wds/checklist.md diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-04-clone-and-wds/lesson.md b/src/modules/wds/course/module-02-installation-setup/lesson-03-clone-and-wds/lesson.md similarity index 100% rename from src/modules/wds/course/module-02-installation-setup/lesson-04-clone-and-wds/lesson.md rename to src/modules/wds/course/module-02-installation-setup/lesson-03-clone-and-wds/lesson.md diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-03-git-setup/lesson.md b/src/modules/wds/course/module-02-installation-setup/lesson-03-git-setup/lesson.md deleted file mode 100644 index b1889a1c..00000000 --- a/src/modules/wds/course/module-02-installation-setup/lesson-03-git-setup/lesson.md +++ /dev/null @@ -1,159 +0,0 @@ -# Lesson 03: Git Configuration - -**Let your IDE handle Git automatically** - ---- - -## What You'll Do - -- Understand what Git does -- Recap your repository structure decision -- Let Cursor install Git automatically -- OR use GitHub Desktop (visual alternative) - -**Time:** 5 minutes - ---- - -## What is Git? - -**Git** is the behind-the-scenes tool that syncs your computer with GitHub. - -**Good news:** You don't need to install it manually! Modern IDEs like Cursor handle this for you. - ---- - -## Step 1: Recap Your Repository Structure - -**You already decided this in Lesson 01 when naming your repo!** - -### Single Repo (named `my-project`) -``` -my-project/ -├── docs/ ← Your WDS specifications -└── src/ ← Code lives here too -``` - -### Separate Repo (named `my-project-specs`) -``` -my-project-specs/ ← This repo (specifications only) - ← Code repo created separately -``` - -**For this tutorial, we assume single repo** (`dog-walker-app`) - ---- - -## Step 2: Choose Your Git Approach - -### Option 1: Let Cursor Handle It (Recommended) - -**The easiest way:** Do nothing! - -When you try to clone a repository in Lesson 04, Cursor will: - -1. Check if Git is installed -2. If not, **automatically prompt you**: "Install Git?" -3. You click **"Install"** -4. Done! - -**That's it.** No command line needed. - -**✅ This is the recommended path for beginners** - ---- - -### Option 2: GitHub Desktop (Visual Alternative) - -**For designers who prefer visual tools:** - -#### Why GitHub Desktop? - -- ✅ No terminal commands needed -- ✅ Visual interface for everything -- ✅ See changes side-by-side -- ✅ Many professional designers use it -- ✅ Works perfectly with Cursor - -#### Install GitHub Desktop - -1. Download from **https://desktop.github.com** -2. Install it (follow standard installer) -3. Open GitHub Desktop -4. Sign in with your GitHub account -5. Done! - -#### How it Works - -- Use GitHub Desktop to **clone** repositories -- Use GitHub Desktop to **commit** and **push** changes -- Use Cursor to **edit** specifications -- They work together perfectly! - -**This is a perfectly valid professional workflow.** - -**Bonus:** GitHub Desktop also helps you decide between single vs separate repos visually! - ---- - -### Option 3: Already Comfortable with Terminal? - -**Optional check for those who want to know:** - -In Cursor terminal (press **Ctrl+`** or **Cmd+`**): - -```bash -git --version -``` - -**If you see a version number:** -``` -git version 2.x.x -``` -✅ Git is installed! - -**If you see "command not found":** -No problem! Continue to Lesson 04, Cursor will prompt you. - ---- - -## Which Option Should You Choose? - -**Choose Option 1 (Let Cursor Handle It) if:** -- You're a complete beginner -- You want the simplest path -- You're comfortable with terminal appearing in Lesson 04 - -**Choose Option 2 (GitHub Desktop) if:** -- You prefer visual interfaces -- You want to see changes graphically -- You're nervous about terminal commands -- You want a tool you'll keep using - -**Both are great!** Many professionals use GitHub Desktop daily. - ---- - -## Troubleshooting - -**Issue:** Not sure which option to choose -**Solution:** Use Option 1 (Let Cursor handle it) - simplest for beginners - -**Issue:** GitHub Desktop won't sign in -**Solution:** Make sure you completed Lesson 01 (GitHub account created) - -**Issue:** Worried about making mistakes -**Solution:** Git saves everything - you can always undo! - ---- - -## What's Next? - -Git will be ready when you need it! Now it's time to clone your repository and add WDS to your workspace. - -**[Continue to Lesson 04: Repository Cloning & WDS Integration →](../lesson-04-clone-and-wds/tutorial.md)** - ---- - -*Part of Module 02: Installation & Setup* -*[← Back to Module Overview](../module-02-overview.md)* diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-05-initiate-mimir/checklist.md b/src/modules/wds/course/module-02-installation-setup/lesson-04-initiate-mimir/checklist.md similarity index 100% rename from src/modules/wds/course/module-02-installation-setup/lesson-05-initiate-mimir/checklist.md rename to src/modules/wds/course/module-02-installation-setup/lesson-04-initiate-mimir/checklist.md diff --git a/src/modules/wds/course/module-02-installation-setup/lesson-05-initiate-mimir/lesson.md b/src/modules/wds/course/module-02-installation-setup/lesson-04-initiate-mimir/lesson.md similarity index 100% rename from src/modules/wds/course/module-02-installation-setup/lesson-05-initiate-mimir/lesson.md rename to src/modules/wds/course/module-02-installation-setup/lesson-04-initiate-mimir/lesson.md diff --git a/src/modules/wds/course/module-02-installation-setup/module-02-overview.md b/src/modules/wds/course/module-02-installation-setup/module-02-overview.md index 4942c7ed..bce6873e 100644 --- a/src/modules/wds/course/module-02-installation-setup/module-02-overview.md +++ b/src/modules/wds/course/module-02-installation-setup/module-02-overview.md @@ -16,53 +16,43 @@ This module takes you from having nothing to being fully set up with WDS, even i ## Lessons -### [Lesson 01: GitHub Setup](lesson-01-setting-up-github/) -**15-20 minutes** +### [Lesson 01: GitHub & IDE Setup](lesson-01-github-and-ide-setup/) +**25-30 minutes** -Create GitHub account, choose username, create or join repository. +Create GitHub account, repository, and install your IDE. -- **[Quick Checklist](lesson-01-setting-up-github/checklist.md)** - Just the steps -- **[Full Lesson](lesson-01-setting-up-github/lesson.md)** - Detailed explanation +- **[Quick Checklist](lesson-01-github-and-ide-setup/checklist.md)** - Just the steps +- **[Full Lesson](lesson-01-github-and-ide-setup/lesson.md)** - Detailed explanation --- -### [Lesson 02: IDE Installation](lesson-02-install-ide/) -**10 minutes** - -Install Cursor or VS Code and do first-launch setup. - -- **[Quick Checklist](lesson-02-install-ide/checklist.md)** - Just the steps -- **[Full Lesson](lesson-02-install-ide/lesson.md)** - Detailed explanation - ---- - -### [Lesson 03: Git Configuration](lesson-03-git-setup/) +### [Lesson 02: Git Configuration](lesson-02-git-configuration/) **5 minutes** Let your IDE handle Git automatically or use GitHub Desktop. -- **[Quick Checklist](lesson-03-git-setup/checklist.md)** - Just the steps -- **[Full Lesson](lesson-03-git-setup/lesson.md)** - Detailed explanation +- **[Quick Checklist](lesson-02-git-configuration/checklist.md)** - Just the steps +- **[Full Lesson](lesson-02-git-configuration/lesson.md)** - Detailed explanation --- -### [Lesson 04: Repository Cloning & WDS Integration](lesson-04-clone-and-wds/) +### [Lesson 03: Repository Cloning & WDS Integration](lesson-03-clone-and-wds/) **15-20 minutes** Clone your repository, add WDS to workspace, create docs structure. -- **[Quick Checklist](lesson-04-clone-and-wds/checklist.md)** - Just the steps -- **[Full Lesson](lesson-04-clone-and-wds/lesson.md)** - Detailed explanation +- **[Quick Checklist](lesson-03-clone-and-wds/checklist.md)** - Just the steps +- **[Full Lesson](lesson-03-clone-and-wds/lesson.md)** - Detailed explanation --- -### [Lesson 05: Mimir Activation](lesson-05-initiate-mimir/) +### [Lesson 04: Mimir Activation](lesson-04-initiate-mimir/) **5 minutes** Drag Mimir file to AI chat and begin your guided journey. -- **[Quick Checklist](lesson-05-initiate-mimir/checklist.md)** - Just the steps -- **[Full Lesson](lesson-05-initiate-mimir/lesson.md)** - Detailed explanation +- **[Quick Checklist](lesson-04-initiate-mimir/checklist.md)** - Just the steps +- **[Full Lesson](lesson-04-initiate-mimir/lesson.md)** - Detailed explanation --- @@ -70,11 +60,11 @@ Drag Mimir file to AI chat and begin your guided journey. **Want the fastest path?** -Follow the checklists in order: [Start with Lesson 01 Checklist →](lesson-01-setting-up-github/checklist.md) +Follow the checklists in order: [Start with Lesson 01 Checklist →](lesson-01-github-and-ide-setup/checklist.md) **Want detailed explanations?** -Follow the full lessons: [Start with Lesson 01 Full Lesson →](lesson-01-setting-up-github/lesson.md) +Follow the full lessons: [Start with Lesson 01 Full Lesson →](lesson-01-github-and-ide-setup/lesson.md) ---