Recent chats
ASKGEEZ Q&A GUIDEWriting & communication

How do I show readers what they need before they start a set of instructions?

Quick answer

Add a short “Before you begin” section before the steps. Group what readers need into prerequisites, materials or files, access, and prior knowledge. Distinguish confirmed requirements from details readers need to check, and use specific names or clearly marked placeholders rather than guessing. End with a readiness check that confirms the essentials together and tells readers what to do if something is missing or uncertain.

LET’S WORK THROUGH IT

The question, the details, the next step.

Question

I’m writing instructions, but readers keep discovering halfway through that they need something first. What should I put before the steps, and how do I decide what belongs there?

Geez

Add a brief “Before you begin” section between the introduction and the steps. Include information that affects whether someone can start or complete the task, grouped into useful categories:

  • Prerequisites: something that must already be done.
  • Materials or files: items readers need to have available.
  • Access: accounts, permissions, locations, or resources they need.
  • Prior knowledge: a skill or earlier instruction they must understand.

Ask whether readers need an item before taking the first step. If they do, list it here. If they will obtain, open, select, or prepare it as part of the process, explain that action at the point where it happens. For example, list a file that must already be available; if a step creates the file, keep that instruction in the sequence and say when readers will need it.

Be specific. Instead of “get everything ready,” name the item or condition, such as “Have the completed [form name] available.” Use a bracketed placeholder while drafting if you do not yet know the exact requirement; do not guess.

Follow-up question

I’m not sure what access readers will have, and some requirements may vary. How can I flag those without making unsupported assumptions?

Geez

Present uncertain or variable details as things to confirm, not as facts that apply to everyone. Keep confirmed requirements distinct from checks. “Required: [permission or account]” signals a known requirement. “Check whether you need [permission]” tells readers to verify whether it applies.

For example: “Confirm that you can access [system or location] before starting. If you cannot, ask [role or team] how access is arranged.” Use a role or team as a placeholder until you know the right contact. If a requirement depends on the reader’s organization or situation, say so explicitly rather than presenting one assumption as universal.

If you cannot verify an important detail before publication, leave a clearly marked drafting placeholder such as “[confirm whether approval is required]” and resolve it before publishing. If readers themselves must check a variable requirement, say what to check and where or with whom to verify it. That gives them a next action without pretending the answer is known.

Follow-up question

What does a useful readiness check look like? I don’t want it to just repeat the list. Could you show a template?

Geez

Make it a short decision point: can readers start now, and what should they do if the answer is no? Confirm the essentials together, then direct readers to the missing prerequisite or a person who can clarify it. Avoid a bare “Ready?” unless readers can tell what “ready” means.

Here’s a reusable template. Replace the bracketed text with verified details:

Before you begin

  • Prerequisite: [What must already be complete]
  • Materials or files: [What the reader needs, with a useful identifier]
  • Access: [What account, location, permission, or resource is needed—or what to confirm]
  • Prior knowledge: [Any skill or earlier instruction the reader must understand]
  • Confirm first: [Any detail that varies by reader and how to check it]

Ready to start? Confirm that [key prerequisite] is complete, [required materials or file] is available, and [needed access or knowledge] is in place. If anything is missing or uncertain, [specific next action or role to ask] before continuing.

Follow-up question

Can you show how that works for a made-up example, and how much detail should I include?

Geez

Suppose the instructions explain how to submit a project update in an internal workspace. These details are illustrative assumptions, not requirements for any actual process:

Before you begin

  • Prerequisite: The project update has been reviewed by [reviewer or role], if review is required for your team.
  • Materials or files: Have the update text and any attachment you plan to include.
  • Access: Confirm that you can open [workspace name] and reach [submission area].
  • Prior knowledge: Know which project the update belongs to.
  • Confirm first: Check whether your team uses a required format or approval step.

Ready to start? You have the update and any attachment, can reach the correct submission area, and know whether your team requires review or a specific format. If anything is unclear, check with [team or role] before following the steps.

The example keeps review and format conditional rather than declaring them mandatory. In your own instructions, include enough detail for readers to identify the exact item, access, or knowledge they need. Add conditions when they change whether or how someone should proceed. Move background explanation to the relevant step or a separate note. Label optional items clearly, and repeat a brief reminder in a step only when it helps prevent confusion.

A practical checklist

  • List only conditions or resources readers need before starting.

  • Separate prerequisites, materials, access, and prior knowledge.

  • Mark variable or unverified details as checks or placeholders, not facts.

  • Give readers a specific next action if something is missing or uncertain.

  • End with a readiness check that confirms the essentials together.

A few more useful answers

Should the pre-start section include optional items?

Include them only if they help readers decide whether or how to proceed. Label them clearly so they are not mistaken for requirements.

What if a prerequisite applies only to some readers?

State the condition explicitly, such as “If your team requires review, complete it before starting.” Tell readers how to confirm whether it applies.

Should I repeat prerequisites in the numbered steps?

Repeat a brief reminder at a step when it prevents confusion, but do not make readers hunt through the instructions to discover the requirements.

YOUR QUESTION. YOUR DETAILS.

Let’s work through your situation.

Get a tailored answer or help with your next task. Starts at $1, with a quote before you pay.

Ask your own question
← Back to Geez at Work