Complete restructure with logical separation:
Lesson 01: Git Setup (15-20 min)
- GitHub account creation
- Repository creation or joining existing
- Single vs separate repo decision at naming
Lesson 02: IDE Installation (10 min)
- Cursor or VS Code choice and installation
- First launch setup
- Terminal verification
Lesson 03: Git Repository Cloning (10 min)
- Create Projects folder
- Clone your repository
- Open in IDE
- Git auto-installation by IDE
Lesson 04: WDS Project Initialization (15-20 min)
- Clone WDS repository
- Add WDS to workspace
- Create 8-phase docs structure
- Activate Mimir
Each lesson:
- 01-quick-checklist.md (checkbox action list)
- 02-full-lesson.md (detailed explanation)
Also organized course explainers:
- Created course-explainers/ folder at course root
- Moved all NotebookLM and YouTube content there
- Cleaner module folders
Benefits:
- Clear logical separation of concerns
- Mimir integrated with WDS init (natural fit)
- Git cloning separate from WDS setup
- Each lesson focused on single topic
- Dual format for all learning styles
Renamed all lesson files with clear numbered prefixes:
Before:
- checklist.md
- lesson.md
After:
- 01-quick-checklist.md
- 02-full-lesson.md
Benefits:
- Clear ordering in file browser
- Easy to see which is quick vs full
- Professional file naming
- Better for navigation
- Consistent across all 4 lessons
Updated module overview with new filenames.
Each lesson now has two files:
- checklist.md: Quick action list with checkboxes
- lesson.md: Full detailed explanation
Overview updated to show both options per lesson.
Updated all Module 02 lesson titles for better scannability:
Before (verb-first):
- Setting Up GitHub
- Install IDE
- Git Setup
- Clone & Add WDS
- Initiate Mimir
After (value-first):
- GitHub Setup
- IDE Installation
- Git Configuration
- Repository Cloning & WDS Integration
- Mimir Activation
Benefits:
- Immediate understanding of what's covered
- Better scannability in overview
- Professional terminology
- Clear value proposition
- Easier to reference specific lessons
Follows principle: Value word should appear as early as possible
in titles for maximum comprehension speed.
Major restructure for better organization and navigation:
New Structure:
- module-02-overview.md (minimal, just links to lessons)
- lesson-01-github-account/tutorial.md
- lesson-02-create-repository/tutorial.md
- lesson-03-install-ide/tutorial.md
- lesson-04-git-setup/tutorial.md
- lesson-05-clone-and-wds/tutorial.md
- lesson-06-initiate-mimir/tutorial.md
Each Lesson Contains:
- Focused tutorial on one specific task
- Clear time estimate
- Step-by-step instructions
- Troubleshooting section
- Navigation to next lesson
Overview Benefits:
- Minimal and scannable
- Easy to navigate between lessons
- See progress through module
- Jump to specific lesson easily
Lesson Benefits:
- Self-contained tutorials
- Focused on single topic
- Can be referenced individually
- Progressive complexity
- Clear completion criteria
Old tutorial-02.md kept for reference until verified working.
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.
Complete rewrite of Installation & Setup module targeting designers with
zero technical experience:
Overview Changes:
- Expanded from 30min to 45-60min to accommodate beginners
- Added GitHub account creation as first step
- Added repository setup and naming guidance
- Added IDE installation (Cursor vs VS Code comparison)
- Reduced prerequisites to absolute minimum (just computer + internet)
- New lesson structure: GitHub → Repository → IDE → Clone → WDS → Mimir
Tutorial Changes (8 detailed steps):
1. Create GitHub Account - Username tips, verification
2. Create Project Repository - Naming, public/private, one vs two repos
3. Install IDE - Cursor vs VS Code, first launch setup
4. Install Git - Check, install, configure
5. Clone Repository - URL, location, terminal commands
6. Add WDS to Workspace - Inside vs beside decision
7. Create Docs Structure - 8-phase folders with platform-specific commands
8. Initiate with Mimir - Drag file, first interaction
New Features:
- Screenshot-worthy step-by-step instructions
- Platform-specific commands (Windows/Mac/Linux)
- Troubleshooting section for common beginner issues
- Visual file structure diagrams
- Pro tips for ongoing use
- Quick reference for 'what lives where'
- Encouragement and celebration at each checkpoint
Target: Designer who has never used GitHub, Git, or an IDE before.
Mårten Angner