chore: release v1.1.0 - add Support Team Guide and User Guide, update all docs to v1.1.0

This commit is contained in:
Alejandro Malo
2026-04-23 23:07:19 -06:00
commit 52e3613d01
85 changed files with 6522 additions and 0 deletions

View File

@@ -0,0 +1,65 @@
<decision_guidance>
# LX Designer Decision Guidance
## When to Use Each Skill
### journey-mapper
- **Use when:** Designing new learning experiences
- **Use when:** Analyzing existing learner flows
- **Skip when:** Journey has already been mapped and validated
### engagement-analyzer
- **Use when:** Reviewing engagement metrics
- **Use when:** Identifying drop-off points
- **Skip when:** No engagement data is available
### gamification-designer
- **Use when:** Adding engagement mechanics
- **Use when:** Designing badge or point systems
- **Skip when:** Content is formal or gamification is inappropriate
### microlearning-architect
- **Use when:** Structuring content for microlearning
- **Use when:** Designing spaced repetition schedules
- **Skip when:** Content is designed for long-form delivery
### ui-spec-generator
- **Use when:** Specifying UI components for developers
- **Use when:** Creating design specifications
- **Skip when:** UI is handled by existing design system
## Design Decisions
### Engagement Level
- **High gamification:** Badges, points, leaderboards, challenges
- Best for: K-12, casual learning, engagement-focused
- **Medium gamification:** Progress bars, completion certificates
- Best for: Professional development, higher education
- **Low gamification:** Minimal game elements, focus on content
- Best for: Academic, compliance, formal training
### Journey Structure
- **Linear:** Fixed sequence for all learners
- Best for: Foundational knowledge, regulated content
- **Adaptive:** Sequence adjusts based on performance
- Best for: Varied learner backgrounds, competency-based
- **Choice-based:** Learners select their own path
- Best for: Self-directed, experienced learners
### Microlearning Unit Size
- **Very short (2-5 minutes):** Single concept, quick practice
- Best for: Mobile learning, just-in-time training
- **Short (5-10 minutes):** Concept + example + practice
- Best for: Standard microlearning, most contexts
- **Medium (10-15 minutes):** Deeper exploration with multiple activities
- Best for: Complex topics, desktop learning
## Trade-offs to Consider
| Decision | Benefit | Cost |
|----------|---------|------|
| More gamification | Higher engagement | Development complexity, potential distraction |
| Adaptive journey | Personalized experience | Complex logic, more content needed |
| Smaller units | Easier to complete | More units to manage, potential fragmentation |
| Choice-based | Learner autonomy | Harder to ensure coverage, complex tracking |
</decision_guidance>