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:
Mårten Angner
parent
9b145af460
commit
9a1bacb377
|
|
@ -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)
|
||||
|
||||
|
|
|
|||
|
|
@ -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!
|
||||
|
||||
---
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue