Choose an observable learning outcome
Begin with a task that matters to adoption: configure a workflow, interpret a result, troubleshoot a failure, or administer access. State what the learner should be able to do independently afterward.Build the learning path
- Identify prerequisites and roles. Separate administrators, daily users, and decision-makers where their tasks differ. Check access, prior knowledge, and available practice environments.
- Choose the smallest useful lesson. Teach one coherent task with enough context to understand why it matters. Link to reference material instead of reading every setting aloud.
- Demonstrate and let the learner practice. Use realistic test data, show the expected result, and include a recoverable mistake. A video watched to completion does not prove the learner can perform the task.
- Provide feedback and help. Explain common errors and how to get assistance. Make recordings, captions, transcripts, or written alternatives available as appropriate.
- Assess the actual capability. Use a completed task, reviewed configuration, or short scenario. Avoid badges that imply expertise beyond what was assessed.
- Connect maintenance to product changes. Assign an owner and version applicability. Retire or update lessons when the interface, workflow, or recommended practice changes.
Worked example
A fictional workflow product teaches administrators to create an approval rule. The lesson includes a test request that intentionally has no matching owner. Learners must configure a fallback and explain why the exception occurred. This reveals whether they understand the operating model, not just whether they can copy a screen. Support reviews recurring mistakes and updates the lesson where the explanation is weak. If many learners fail the same step, the product team also investigates the interface.Lesson design card
Evaluate the program
Compare successful task performance, time to independent use, and relevant support patterns. Account for differences in customer complexity before attributing adoption improvements to training. Course enrollment is a reach measure; learning and customer outcomes need their own evidence.Try it with your own work
Choose one common task. Give a learner test data, a clear goal, and a way to check the result. Watch where they need help before adding another lesson.Sources and scope
- Diátaxis distinguishes learning-oriented tutorials from other documentation needs; lesson design and assessment here are original guidance.
What to read next
Documentation · Customer onboarding · Customer community Chapter guide · All playbooksCopyright © 2026 Ivan Xu. All rights reserved. See the copyright and reuse terms. Canonical source: github.com/weilun88313/B2B-Playbook