The kinds of content, and when to use each
Lessons, blocks, questions, sims, tags and narration — what each is for.
6 min read
A course is built from lessons and questions. Within a lesson you assemble blocks — the same way you'd build a document out of paragraphs, headings and callouts.
Lesson blocks
| Block | Use it for |
|---|---|
| Text | Ordinary explanation. The workhorse. |
| Heading | Breaking a long lesson into sections a reader can scan. |
| Callout | Pulling one thing out of the flow so it can't be missed. |
| Steps | A numbered procedure that must be done in order. |
| Image | A diagram, a photo of correct positioning, a figure from an SOP. |
| Video | A demonstration — paste a YouTube or Vimeo link, or upload your own file. |
The four callout types
| Callout | Meaning |
|---|---|
| Why it matters | The consequence. Why a person should care about doing this right. |
| Watch out | A hazard or a common, costly mistake. Use sparingly so it keeps its force. |
| Tip | Something that makes the job easier but isn't safety-critical. |
| Note | An aside, an exception, a local quirk. |
Questions
Questions do double duty: they form the baseline assessment for new people, and afterwards they come back in Daily Rounds at spaced intervals to check that knowledge held. A question that only ever gets asked once teaches very little — the spacing is what makes it stick.
You can also write coaching for each wrong answer, so somebody who picks the wrong option is told why it's wrong rather than just being marked down.
Sims
Scenario practice for judgement calls that a multiple-choice question can't capture — the kind of thing where the right answer depends on what else is going on. Managed under Content → Sims.
Tags
Courses can be tagged by species and theme — equine, bovine, avian, reptile, safety, clinic — so you can filter to just the content that matters for a given animal or subject. Set them in a course's settings.
Audio narration
Every lesson gets a spoken version so people can train hands-free while driving to a farm call. It's generated automatically and refreshes after you edit a lesson, so there's nothing to maintain by hand.