‹   Learning hub
Writing

Write an answer-first page

Make a procedural page useful to someone who has a task to finish right now.

Download .md

Name the question

Ask a colleague to describe the problem in their own words. Use the action and object in the title. “Request a replacement device” gives a reader a clearer destination than a broad equipment heading.

Put the decision up front

Use the opening paragraph to explain who can use the procedure, what they need and where to begin. Put any decision that changes the route before the steps it affects.

Observe one reader

Give a teammate the page and a realistic scenario. Watch where they hesitate. Rewrite that instruction, add the missing example or move the relevant condition earlier. Repeat with a second scenario before marking the page reviewed.