Source: https://polysh.io/blog/review-narration-for-a-software-tutorial/

NARRATION / PRACTICAL GUIDE

# Review narration so it matches the software on screen.

Before choosing a voice or translating a tutorial, make the script precise. Names, timing, and expected results matter more than sounding formal.

By the Polysh team3 October 2026

## Use the name on the screen.

The viewer should be able to connect a sentence to a control without guessing. “Select Invite member” is more useful than “press this button.” Check product names, menu items, and abbreviations against the recording.

Speech recognition can mishear a product name or a short label. Fix those words before creating narration. Use the project’s protected terms for names that should remain consistent through rewriting or translation.

## Keep one action in one sentence.

A long sentence can run ahead of the screen. Break the explanation into the action and what happens next. The viewer gets a moment to find the control, then sees why they used it.

ROUGH

“You can sort of go into the team bit and put in the person and then they’ll get access.”

REVIEWED

“Open Your team. Select Invite member and enter their email. Send the invitation, then check that their status reads Invite pending.”

## Read it with the recording.

Play the workflow and read the script aloud. Is the action mentioned before or as it happens? Does the sentence describe the screen that is actually visible? Does it explain a result the viewer can recognize?

Trim a detour rather than writing around it. Keep enough time for a meaningful result to register. When the script feels clear, generate the voiceover and listen to the whole passage for pronunciation and pacing.

## Review each language as its own explanation.

A translated version should preserve the task and the names your audience sees. Review that language’s script before exporting, especially when control labels remain in the original product language.

After making further script edits, regenerate the relevant narration so the exported voice matches the approved words. Keep the original recording as the source for your revised version.

PUT IT TO WORK

## A clearer explanation starts here.

### Explore AI voiceover

See how this workflow fits into the Polysh workspace.

[Explore the workflow](https://polysh.io/products/ai-voiceover/)

### See the example

Follow a fictional team invitation from rough explanation to useful guide.

[Explore an example](https://polysh.io/examples/)

### More practical guides

Useful ideas for narration, documentation, and sharing.

[Browse the blog](https://polysh.io/blog/)