fix(wds): Remove manual Git installation requirement from Module 02
Major UX improvement for complete beginners: Tutorial Changes (Step 4): - REMOVED: Manual Git installation steps with command line - ADDED: Explanation that IDE handles Git automatically - ADDED: GitHub Desktop as visual alternative for non-technical users - NEW APPROACH: Let Cursor prompt for Git installation when needed Key improvements: - Beginners don't need to manually install Git - Cursor/VS Code will automatically prompt when cloning - Optional GitHub Desktop path for visual learners - Reduces friction and confusion for designers - Eliminates 'why am I doing this?' questions Overview Changes: - Updated lesson descriptions to match tutorial flow - Clarified Git is handled automatically - Updated completion checklist - Improved tutorial description Reasoning: Complete beginners don't need to understand Git installation. Modern IDEs handle this transparently. Let the tools do the work. Designers can focus on design, not developer tooling.
This commit is contained in:
parent
9b145af460
commit
9a1bacb377
|
|
@ -37,48 +37,58 @@ Before you can design with WDS, you need a solid foundation:
|
||||||
|
|
||||||
## Module Contents
|
## Module Contents
|
||||||
|
|
||||||
### Lesson 1: Installing WDS
|
### Lesson 1: Create Your GitHub Account
|
||||||
**Reading time:** 5 minutes
|
**Reading time:** 5 minutes
|
||||||
|
|
||||||
- System prerequisites
|
- Why GitHub for designers
|
||||||
- Clone and install
|
- Creating your account
|
||||||
- Verify installation
|
- Choosing a username
|
||||||
- Troubleshooting common issues
|
- Setting up your profile
|
||||||
|
|
||||||
### Lesson 2: Understanding WDS Structure
|
### Lesson 2: Create Your Project Repository
|
||||||
**Reading time:** 10 minutes
|
**Reading time:** 10 minutes
|
||||||
|
|
||||||
- The `docs/` folder philosophy
|
- Repository naming conventions
|
||||||
- 8-phase folder structure
|
- One repo vs. separate repos (specs + code)
|
||||||
- How WDS organizes your thinking
|
- Public vs. private repositories
|
||||||
- Where AI agents look for information
|
- Initial repository setup
|
||||||
|
- README basics
|
||||||
|
|
||||||
### Lesson 3: Creating Your First Project
|
### Lesson 3: Install Your IDE
|
||||||
**Reading time:** 5 minutes
|
**Reading time:** 5 minutes
|
||||||
|
|
||||||
- Project folder setup
|
- Cursor vs. VS Code - which to choose
|
||||||
- Initial configuration
|
- Download and installation
|
||||||
- Workspace organization
|
- Basic IDE orientation
|
||||||
- Best practices
|
- Essential settings for designers
|
||||||
|
|
||||||
### Lesson 4: Meet Your WDS Agents
|
### Lesson 4: Clone Your Project (Git Handled Automatically!)
|
||||||
**Reading time:** 10 minutes
|
**Reading time:** 10 minutes
|
||||||
|
|
||||||
- Mimir: Your guide and orchestrator
|
- Understanding "cloning"
|
||||||
- Freyja: The UX designer
|
- The IDE handles Git installation for you
|
||||||
- Saga: The strategic analyst
|
- Visual alternative: GitHub Desktop
|
||||||
- Idunn: The PM and coordinator
|
- Clone your project repository
|
||||||
- When to use each agent
|
- 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:
|
Once you've completed Module 02:
|
||||||
|
|
||||||
- ✅ WDS is installed and verified
|
- ✅ GitHub account created and repository set up
|
||||||
- ✅ You understand the folder structure
|
- ✅ IDE installed (Cursor or VS Code)
|
||||||
- ✅ Your first project is set up
|
- ✅ Your project cloned to your computer
|
||||||
- ✅ You know which agents to call
|
- ✅ 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)
|
**Next:** [Module 03: Create Project Brief](../module-03-project-brief/module-03-overview.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.
|
**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:
|
### 4.1 Let Cursor Install Git Automatically
|
||||||
1. Press **Ctrl+`** (Windows/Linux) or **Cmd+`** (Mac) to open terminal
|
|
||||||
2. Type: `git --version`
|
|
||||||
3. Press Enter
|
|
||||||
|
|
||||||
**If you see a version number (like `git version 2.x.x`):**
|
When you try to clone a repository in Step 5, Cursor will:
|
||||||
✅ Git is installed! Skip to Step 5.
|
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":**
|
**That's it.** No command line needed.
|
||||||
Continue to 4.2 below.
|
|
||||||
|
|
||||||
### 4.2 Install Git
|
### 4.2 Alternative: GitHub Desktop (Even Easier!)
|
||||||
|
|
||||||
**Windows:**
|
**For designers who prefer visual tools:**
|
||||||
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
|
|
||||||
|
|
||||||
**Mac:**
|
1. Download **GitHub Desktop** from **https://desktop.github.com**
|
||||||
1. In Cursor terminal, type: `git --version`
|
2. Install it
|
||||||
2. Mac will prompt you to install developer tools
|
3. Sign in with your GitHub account
|
||||||
3. Click "Install" and wait for it to complete
|
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
|
```bash
|
||||||
# Ubuntu/Debian
|
git --version
|
||||||
sudo apt-get install git
|
|
||||||
|
|
||||||
# Fedora
|
|
||||||
sudo dnf install git
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### 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):
|
**✅ Checkpoint:** Don't worry about this yet - continue to Step 5!
|
||||||
|
|
||||||
```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
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue