Most training sessions fail in one of two ways. Either they stay so high level that nobody could do anything afterwards, or they dive into the details so fast that nobody knows why they are looking at them.
The fix is a shape I call the training swoop.
1. Tell
Start high. Set the context. What is this thing, what problem does it solve, and why should the people in the room care? Take as long as that needs. For a quick walkthrough it might be a minute, for a new team it might be half the session. The point is not brevity, it is altitude. Stay above the details so everyone has a place to hang them when they arrive.
2. Show
Now drop all the way down. Open the tool, run the command, walk through the real screen. This is where the learning actually happens, and it only works because step one told people what they were looking at. Don’t summarise here. Let them see how it works, including the messy bits.
3. Tell
Climb back out. Now that they have seen it work, go back over what matters, what they should do next, and what they can safely ignore. This is often where the real questions come, because people finally have enough context to ask them. Give it room. People remember the last thing you said, so make it the thing you want them to remember.
That’s it. High, low, high. It works for a five minute walkthrough of a new deploy process and it works for a full day onboarding session. If you only do the top, nobody learns. If you only do the bottom, nobody remembers why.