Writes e-learning module content including explanations, examples, and instructional text. Use when creating module content, writing topic explanations, developing examples, or when user mentions "write content," "module text," "explain topic," "content development," or "instructional content."
Guide for writing effective instructional content for e-learning modules.
Follow this structure for each content section:
1. HOOK (Attention)
- Question, scenario, or surprising fact
- "Why does this matter to you?"
2. OBJECTIVE (Expectation)
- What learner will be able to do
- Clear, specific outcome
3. CONTENT (Instruction)
- Chunked information (5-7 items max)
- Examples for each concept
- Visual support references
4. PRACTICE (Application)
- Knowledge check or activity
- Immediate feedback
5. SUMMARY (Reinforcement)
- Key takeaways (3-5 points)
- Connection to next topic
Apply the 7±2 rule:
## [Concept Name]
[One-sentence definition]
**Why it matters:** [Relevance to learner's job/goals]
### How it works
[2-3 paragraphs explaining the concept]
### Example
[Concrete, realistic example from learner's context]
### Key Points
- [Point 1]
- [Point 2]
- [Point 3]
## How to [Task Name]
[Brief context - when and why to do this]
### Steps
1. **[Action verb] [object]**
[Brief explanation if needed]
2. **[Action verb] [object]**
[Brief explanation if needed]
3. **[Action verb] [object]**
[Brief explanation if needed]
### Tips
- [Helpful tip 1]
- [Helpful tip 2]
### Common Mistakes
- [Mistake to avoid]
- [Mistake to avoid]
## [Topic A] vs. [Topic B]
[Brief intro explaining why comparison matters]
| Aspect | [Topic A] | [Topic B] |
|--------|-----------|-----------|
| [Aspect 1] | | |
| [Aspect 2] | | |
| [Aspect 3] | | |
### When to use [Topic A]
[Situations where A is better]
### When to use [Topic B]
[Situations where B is better]
The implementation of the new customer relationship management system will necessitate that all employees undergo comprehensive training to ensure optimal utilization of the platform's capabilities and features.
You'll need training on the new CRM system before you can use it effectively. This module covers the essential features you'll use every day.
It is important to understand that there are multiple factors that should be considered when making a decision about which approach to take.
Consider these three factors before choosing your approach:
- Timeline - How quickly do you need results?
- Budget - What resources are available?
- Risk - What could go wrong?
Add visual callouts in your content:
[IMAGE: Diagram showing the three-step process]
[VIDEO: 2-minute demonstration of the software interface]
[ANIMATION: How data flows through the system]
Write descriptive alt text:
alt="Bar chart showing sales increased 40% in Q3"alt="Flowchart: Step 1 leads to Step 2, which branches to Step 3a or 3b"alt="Settings menu with Privacy option highlighted"Before finalizing content:
Save content to: course-template/02-development/modules/module-XX/content/