There are 5 moments of learning need:
1. When you learn something for the first time
2. When you want to learn more,
3. When you try to apply and / or remember
4. When something goes wrong
5. When things change
This has subtle power when you think about how what you're doing (or not doing) maps to each need.
For example, you could map each moment to a piece of developer education:
1. Getting started tutorial
2. How-tos, conceptual guides, courses
3. API reference and samples, sandboxes, labs
4. Troubleshooting docs, error docs
5. Migration guides, roadmaps, announcement blog posts
Or to developer experience:
- Starters, templates, and CLIs
- Generated code docs (e.g. JSdoc, Javadoc)
- Copilot, discoverable APIs, type annotations
- Descriptive error messages, graceful error handling
- Codemods, semantic versioning, release notes, regression testing
Or to your community:
- Welcome area
- Ask questions, hold office hours
- Cohort-based learning
- Community support / on-call
- Announcements, streams, events
Questions to ask:
1. Do you have learning content that serves each need?
2. Are there unmet needs you don't have yet?
3. How easy is it to find when these needs arise?
Have a lovely day,