Describe the reader and the task

Replace a vague topic such as image SEO with a specific decision: a developer needs a responsive product photo that preserves a visible subject and loads at an appropriate size. Identify what they already know, which constraints matter and what action should be possible at the end. This gives the brief a meaningful scope.

Write the answer you intend to support

Draft a short provisional answer before the outline. Then list the evidence needed to make it reliable: an example, a comparison, a measurement or an official reference. If you cannot explain the conclusion clearly, adding ten more headings is unlikely to solve the underlying uncertainty. Resolve that uncertainty before polishing a title.

Outline the explanation in reading order

Put prerequisites before instructions and caveats beside the actions they qualify. A useful tool guide can cover inputs, an example, output interpretation and failure cases. Use the Heading Outline Checker to inspect the planned structure, then read it aloud. The outline should describe the reader’s progress rather than repeat keyword variations at every level.

Choose an example with a useful failure case

A UTM article should show an existing query string and a fragment, not only an empty example domain. A CSS guide should show what gets cropped. Include a case where the default recommendation is unsuitable, such as a diagram that must remain completely visible. That helps readers understand the boundary of the advice.

Choose a next step that continues the task: a worked tutorial, an image utility or an encoding explanation. Write the link text as a description of what the reader will find. Avoid automatically adding popular pages unrelated to the current problem. The brief should explain why each suggested destination belongs in the workflow.

Set an editorial completion test

Ask another reader to complete the intended task with the draft. Record where they hesitate, which terms need explanation and whether the example actually works. Check the final title and description against the completed content. A clear, useful article is a stronger deliverable than meeting a word-count target with repeated advice.

text / WORKED EXAMPLE
Reader: frontend developer
Task: crop a photo without distortion
Answer: define a frame, use object-fit, test the focal point
Evidence: cover/contain comparison and responsive HTML
Failure case: screenshot labels that must remain visible
Next step: calculate source dimensions and compress the asset

Frequently asked questions

How many words should the article have?

Use enough detail to solve its task and explain important conditions. Do not add filler to reach an arbitrary length.

Should the brief promise a ranking?

No. It should define the user problem and an assessable editorial result.

Further reading

Put the idea to work.

Explore free browser tools for images, text and developer workflows.

Try a free tool