Define the learning outcome

State what the learner should be able to do after the lesson. For example, “prepare and check a final document” is more specific than “learn about working with documents.” Use that outcome to choose the essential actions and useful explanations.

List any knowledge, files, tools and permissions needed before starting. If the video covers several independent tasks, give them separate sections or make separate guides.

Study notes help readers recall the main ideas and how they connect. A study guide describes what to do and under which conditions. For help choosing the right source material for each format, see the article on transcripts, key points and summaries.

Mark up the transcript

Identify definitions, commands, sequences and warnings. Mark the action that each explanation refers to. A remark such as “before that, you also need to…” may be an important prerequisite that belongs at the beginning.

Keep timecodes for demonstrations: a setting, an example or a mistake. A transcript captures speech. Check button labels, field values and cursor movements against the relevant video frame.

Speech

Actions and explanations

Extract the steps, conditions, terms and warnings from the text.

Video frames

Demonstration details

Check the interface in the video and choose the screenshots you need.

Verified study guide

Combine the text and visual examples into a sequence the learner can follow.

How to build a guide from speech and video frames. Use the video to check visual actions and supplement the transcript.

Build a step-by-step study guide

Organize the document around actions. Begin with the objective and required materials. Then describe the steps, expected result and common mistakes. Link to the relevant video excerpts next to difficult steps.

Start each step with a specific action, then explain why it matters and how to tell it worked. Put alternative methods or exceptions in their own section so the main sequence stays easy to follow.

Example of one step

Create a working copy of the file

Action
Copy the practice file into the exercise folder and add “practice” to the filename.
Why
Keep the original intact and do the exercise in a separate copy.
Result
The original stays in place and a separate file with the new name opens from the working folder.
Illustration
If helpful, show the part of the file list where both the original and the copy are visible. The screenshot should match the action described.
Possible mistake
The original file was renamed instead of copied. Check that both files exist before continuing the exercise.
The structure of one step in the study guide. This is an illustrative teaching example. It does not describe the Transkribator interface.

Remove repetitions from spoken explanations while keeping the reasoning. If the instructor explained why a setting matters or when it should not be used, keep that explanation in the written guide.

Check that the material is current

The interface, product rules or learning files may have changed since the lesson was recorded. Repeat the actions in the current version and verify labels, links and permissions. If the instructions apply to a specific version, state it alongside the prerequisites.

Update the text and screenshots together. A new button name beside an old screenshot can confuse readers. Change the update date after a substantive revision and briefly explain the change if needed.

For regulated or high-risk subjects, have a qualified specialist review the material. Copyediting does not replace checking the recommendations themselves.

Make the guide easy to use

Use short paragraphs, numbered steps and captions under images. Include a screenshot where it helps the learner find something or compare a result. Crop away unnecessary areas while keeping the context, and check that key labels are readable on a phone.

Let readers enlarge detailed images and scroll wide tables horizontally. Include a table of contents in a long document. A short video summary can help you create an initial outline. Check that outline against the learning objective.

Finish with a clear check: what should the learner end up with, and how can they verify it? Ask someone who has not seen the lesson to follow the guide. Note where they had to guess and add an explanation there. Include related material when it extends the task and is already available to learners.

Practical checklist

  • State the learning outcome and prerequisites.
  • Link complicated demonstrations to their timecodes.
  • Check interface labels against the video frames and the current product version.
  • Add illustrations to the steps that need them.
  • Keep warnings, restrictions and the reasons behind actions.
  • Follow the guide yourself and check the final result.

How to do this in Transkribator

On the “Video to text” page choose the finished file. Make sure it contains an audible speech track, then start processing. When processing finishes, review the overview, full transcript and timestamps.

Download the TXT file and create your own learning document. Go back to the video to check the actions shown and capture the screenshots you need. Finish by checking terms, the order of the steps and the expected result.

Key points

  • The learning objective determines the guide’s structure.
  • Speech explains the process and video frames help you check the actions shown.
  • Each step should lead to a clear result.
  • Timecodes connect the text to the demonstration.
  • Test the material in practice and update it when the process changes.

Frequently asked questions

Can the service recognize buttons shown on screen?

The transcript is generated from the video's audio track. Check button labels, field values and silent demonstrations in the video frames, then add them to the guide separately. “Click here” needs an explanation of which item to select and where to find it.

Can I generate a finished study guide automatically?

A transcript, key points and a summary can help you prepare a draft. The author or editor should define the learning objective, check the order of actions, add illustrations where needed and follow the instructions to the expected result. A transcript alone does not establish that the material is ready.

Do I need timecodes in the final guide?

They help next to a complex demonstration, an example or a walkthrough of a mistake. Timecodes used only for editorial checks can stay in the working draft. Make sure learners can access any video you link to.

How often should I update the guide?

Review it when the interface, process, data or conditions for completing the task change. After a substantial revision, give the actual update date and the product version if it matters to the instructions. Check links and access to the learning files separately.