refactor(wds): Merge GitHub and IDE into single Lesson 01
Final streamlined structure - 4 lessons instead of 5: Lesson 01: GitHub & IDE Setup (25-30 min) - MERGED! - Part 1: GitHub account + repository - Part 2: IDE installation - Single cohesive lesson for initial setup Lesson 02: Git Configuration (5 min) Lesson 03: Repository Cloning & WDS Integration (15-20 min) Lesson 04: Mimir Activation (5 min) Total time: 45-60 minutes (unchanged) Benefits: - Fewer context switches - More logical grouping - Get account + IDE done together - Cleaner progression - Each lesson still has checklist + full version
This commit is contained in:
Mårten Angner
parent
4335c0fc54
commit
a6aa3a8dda
|
|
@ -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)*
|
||||
|
||||
|
|
@ -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)
|
||||
|
||||
|
|
@ -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)*
|
||||
|
||||
|
|
@ -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)
|
||||
|
||||
|
|
@ -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)*
|
||||
|
|
@ -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)*
|
||||
|
||||
|
|
@ -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)**
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -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)*
|
||||
|
||||
|
|
@ -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)
|
||||
|
||||
|
|
@ -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)*
|
||||
|
|
@ -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)*
|
||||
|
|
@ -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)
|
||||
|
||||
---
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue