Student Language Guide
Instructions
When writing student-facing content:
- Use clear, accessible language
- Avoid internal jargon and labels
- Include analogies for complex concepts
- Match language complexity to layer
Golden Rules
- Never expose internal labels (L1, L2, etc. to students)
- Avoid jargon without explanation
- Use active voice for instructions
- Include analogies for abstract concepts
- Be encouraging but not condescending
Language Dos and Don'ts
| DO | DON'T | |----|-------| | "In this lesson, you'll learn..." | "This L2 content covers..." | | "Think of a robot like a..." | "The robot abstraction..." | | "Try this exercise" | "Execute the following procedure" | | "You've learned a lot!" | "Basic concepts completed" |
Reference
See examples.md for good/bad examples.