A PRACTICAL NOTE · Formatting

How to apply this guide

Dictate the observed behavior, impact and desired outcome without suggesting something you didn’t test.

Start with

Say the app and edition, what you clicked, what you expected and what actually appeared. Include a harmless example phrase if recording or insertion is part of the problem.

Check before you finish

Read the final text and remove private material. End with the behavior you want rather than asserting a cause you cannot verify.

Evidence to keep: Compare the source words with the formatted draft and make sure meaning, names, dates and commitments remain intact. This page’s key limit is: Dictate the observed behavior, impact and desired outcome without suggesting something you didn’t test.

Start here

Feedback becomes actionable when it explains what you were doing and what you saw. Beginners and experienced users can give different examples of the same problem, so include enough detail to differentiate them.

Record the exact situation

Say the app and edition, what you clicked, what you expected and what actually appeared. Include a harmless example phrase if recording or insertion is part of the problem.

State the impact honestly

Explain how the behavior affected your task. If you only tried the feature once, say so. A rewrite should preserve whether the problem was consistent or observed once.

Confirm before sharing

Read the final text and remove private material. End with the behavior you want rather than asserting a cause you cannot verify.

Keep exploring