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 e237899d..d1409aaf 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 @@ -37,48 +37,58 @@ Before you can design with WDS, you need a solid foundation: ## Module Contents -### Lesson 1: Installing WDS +### Lesson 1: Create Your GitHub Account **Reading time:** 5 minutes -- System prerequisites -- Clone and install -- Verify installation -- Troubleshooting common issues +- Why GitHub for designers +- Creating your account +- Choosing a username +- Setting up your profile -### Lesson 2: Understanding WDS Structure +### Lesson 2: Create Your Project Repository **Reading time:** 10 minutes -- The `docs/` folder philosophy -- 8-phase folder structure -- How WDS organizes your thinking -- Where AI agents look for information +- Repository naming conventions +- One repo vs. separate repos (specs + code) +- Public vs. private repositories +- Initial repository setup +- README basics -### Lesson 3: Creating Your First Project +### Lesson 3: Install Your IDE **Reading time:** 5 minutes -- Project folder setup -- Initial configuration -- Workspace organization -- Best practices +- Cursor vs. VS Code - which to choose +- Download and installation +- Basic IDE orientation +- Essential settings for designers -### Lesson 4: Meet Your WDS Agents +### Lesson 4: Clone Your Project (Git Handled Automatically!) **Reading time:** 10 minutes -- Mimir: Your guide and orchestrator -- Freyja: The UX designer -- Saga: The strategic analyst -- Idunn: The PM and coordinator -- When to use each agent +- Understanding "cloning" +- The IDE handles Git installation for you +- Visual alternative: GitHub Desktop +- Clone your project repository +- Add WDS to your workspace +- Create docs folder structure + +### Lesson 5: Initiate with Mimir +**Reading time:** 5 minutes + +- The Mimir orchestrator file +- Drag-to-chat initialization +- What Mimir will ask you +- Your first guided session --- -## Tutorial: Quick Installation +## Tutorial: Complete Beginner Setup -**For hands-on learners who want to dive right in:** +**For hands-on learners who want step-by-step instructions:** -[→ Tutorial 02: Install WDS in 5 Minutes](tutorial-02.md) +[→ Tutorial 02: Complete Beginner Setup](tutorial-02.md) -Step-by-step guide with copy-paste commands and verification checkpoints. +**8 detailed steps** from GitHub account creation to Mimir activation, with screenshots-worthy instructions and platform-specific commands. --- @@ -86,10 +96,12 @@ Step-by-step guide with copy-paste commands and verification checkpoints. Once you've completed Module 02: -- ✅ WDS is installed and verified -- ✅ You understand the folder structure -- ✅ Your first project is set up -- ✅ You know which agents to call +- ✅ GitHub account created and repository set up +- ✅ IDE installed (Cursor or VS Code) +- ✅ Your project cloned to your computer +- ✅ WDS added to your workspace +- ✅ Docs folder structure created +- ✅ Mimir activated and ready to guide you **Next:** [Module 03: Create Project Brief](../module-03-project-brief/module-03-overview.md) diff --git a/src/modules/wds/course/module-02-installation-setup/tutorial-02.md b/src/modules/wds/course/module-02-installation-setup/tutorial-02.md index 1091ab28..53565d8b 100644 --- a/src/modules/wds/course/module-02-installation-setup/tutorial-02.md +++ b/src/modules/wds/course/module-02-installation-setup/tutorial-02.md @@ -148,57 +148,48 @@ Cursor will ask you a few questions: --- -## Step 4: Install Git 🔧 +## Step 4: Let the IDE Handle Git 🔧 **What is Git?** The behind-the-scenes tool that syncs your computer with GitHub. -### 4.1 Check if Git is Already Installed +**Good news:** You don't need to install anything manually! Modern IDEs like Cursor handle this for you. -In Cursor: -1. Press **Ctrl+`** (Windows/Linux) or **Cmd+`** (Mac) to open terminal -2. Type: `git --version` -3. Press Enter +### 4.1 Let Cursor Install Git Automatically -**If you see a version number (like `git version 2.x.x`):** -✅ Git is installed! Skip to Step 5. +When you try to clone a repository in Step 5, Cursor will: +1. Check if Git is installed +2. If not, **automatically prompt you to install it** +3. Click "Install" when prompted +4. Done! -**If you see "command not found":** -Continue to 4.2 below. +**That's it.** No command line needed. -### 4.2 Install Git +### 4.2 Alternative: GitHub Desktop (Even Easier!) -**Windows:** -1. Download from **https://git-scm.com/download/win** -2. Run the installer -3. Use all default settings (just keep clicking "Next") -4. Restart Cursor after installation +**For designers who prefer visual tools:** -**Mac:** -1. In Cursor terminal, type: `git --version` -2. Mac will prompt you to install developer tools -3. Click "Install" and wait for it to complete +1. Download **GitHub Desktop** from **https://desktop.github.com** +2. Install it +3. Sign in with your GitHub account +4. Use it to clone repositories (visual interface, no commands!) -**Linux:** +**Then** open the cloned folder in Cursor. + +**This is perfectly valid!** Many professional designers use GitHub Desktop. + +### 4.3 Already Comfortable with Terminal? + +If you want to verify Git is installed: + +In Cursor terminal (press **Ctrl+`** or **Cmd+`**): ```bash -# Ubuntu/Debian -sudo apt-get install git - -# Fedora -sudo dnf install git +git --version ``` -### 4.3 Configure Git (First Time Only) +If you see a version number → you're good! +If not → Continue to Step 5, Cursor will prompt you. -In Cursor terminal, type these commands (replace with YOUR info): - -```bash -git config --global user.name "Your Name" -git config --global user.email "your.email@example.com" -``` - -**Use the same email you used for GitHub!** - -**✅ Checkpoint:** `git --version` shows a version number +**✅ Checkpoint:** Don't worry about this yet - continue to Step 5! ---