4 shots · about 41 s of finished video · lesson 4 of Recording tutorials & testing with the guides
Record as
Any staff login
Sign in at /demo on a demo-mode build
Screens
/help/[course]/[lesson] /help/production
Length
41 s
narration at ~150 words/min + screen time
Status
Not yet recorded
One entry per lesson in the videos file makes the video play inside the help centre, with “Watch this step” links from every step.
| # | Screen | Action (on screen) | Must be visible | Voice-over | ~s |
|---|---|---|---|---|---|
| 1 | /help/[course]/[lesson] | Take the YouTube id from the video's address: in https://www.youtube.com/watch?v=dQw4w9WgXcQ the id is dQw4w9WgXcQ. | A short id made of letters, digits, - and _. | The help centre only needs the id, never the full link. | 8 |
| 2 | /help/[course]/[lesson] | Send the developer (or add yourself, in the source file src/lib/help/videos.ts) one entry keyed by the lesson slug: the id, the length in seconds, the language, and the chapters map of step number to start second from the edit. Callout: The automated tests refuse an entry whose slug is not a real lesson or whose chapter numbers exceed the lesson's step count, so a typo cannot ship. | An entry like "fees-collect-cash": { youtubeId: "dQw4w9WgXcQ", durationSec: 312, language: "en", chapters: { 1: 0, 2: 18, 3: 41 } }. | Chapters are optional, but with them every step in the guide gets a Watch link that jumps to the right second. | 12 |
| 3 | /help/[course]/[lesson] | After the next deployment, open the lesson. | The video plays above the steps (privacy-friendly youtube-nocookie embed) and steps with a chapter show Watch this step. | The video and the written steps now live together, and a viewer can switch between them at any point. | 12 |
| 4 | /help/production | Check Help → Recording plan: the lesson's status is now Recorded, and the course card on the help home shows the video count. | The counters move and the lesson no longer appears under Not recorded. | The plan keeps the series honest: what is done, what is left. | 9 |
After the video is published
Add its YouTube id under video-attach-a-video in src/lib/help/videos.ts, with a chapters map of step number → seconds. The lesson page then shows the video and a “Watch this step” link on every step. See the video production guide.