
A good example helps the reader make the decision the article just described. Before adding a case, name the question the example needs to answer. Then keep the details that affect the answer.
Start with a decision the reader recognizes
If a section explains how to review a screenshot, pick a case where an editor must decide whether the image helps explain a step. A short example that shows the exact menu or field gives the reader something to check.
Keep the details that change the answer
Describe the setting, the choice and the result. For instance, a screenshot in an export guide might show a file-type selector. A caption that names the selector explains why the screenshot is useful. The color of the surrounding window can usually stay out of the example.
Label scenarios and verify real examples
Tell the reader when the scenario is fictional. When using a real example, verify that the source supports the specific detail you describe. Explain the scope of the example so readers can see where the same reasoning applies.
Give the reader a check they can reuse
Close the example with a question such as “Can the reader identify the field and tell when to use it?” If a screenshot is part of the example, use the guest post screenshot caption guide to make the visual easier to follow.