← All content

How to Write a Test Plan People Will Use

September 18, 2019· Jorge Iglesias· QA & Testing

A test plan explains how a team will gather enough evidence to make a release decision. Its value comes from the decisions it records, not its length.

Start with the change. A plan for a quantity selector should be smaller than a plan for replacing an entire payment flow. Both should make scope, risks, responsibilities, and remaining uncertainty clear.

Answer five practical questions

  • What will be tested? Identify the behavior and the important failure conditions.
  • Who will do it? Name the people responsible for preparation, execution, investigation, and the release decision.
  • When will it happen? Include dependencies such as a stable build or prepared test data.
  • Where will it run? Record the environments, browsers, devices, and relevant integrations.
  • How will it be checked? Explain which work will be exploratory, scripted, automated, or reviewed with a specialist.

Also say what is outside scope. An explicit exclusion helps the team avoid treating an untested area as covered.

Example: a small reservation change

Imagine a reservation form that must reject quantities above the remaining ticket stock.

The main risk is overselling. Check a valid reservation, the last available ticket, an excessive request, a failed response, and repeated submission. Review stock updates with the developer; clicking the page alone may not show whether the underlying operation is safe.

Use an isolated test event with a known ticket count. Record the starting count and reset it between independent cases. List the browsers the release actually supports rather than promising coverage of every possible device.

Agree on entry and exit conditions

Entry conditions explain what must be ready before testing is meaningful: the intended build, access to the environment, known data, and a way to inspect results.

Exit conditions explain what evidence the team expects before deciding to release. For this example, every stock-related acceptance criterion should have a result, serious overselling defects should be resolved, and any remaining gaps should have a named decision owner.

These are decision aids, not a guarantee that no defect exists.

Keep the plan useful

Review the plan with product and development colleagues before investing heavily in detailed cases. Update it when requirements or risks change.

At the end, compare the planned coverage with the work actually completed. A short explanation of what changed is more useful than a perfect-looking plan that no longer describes the release.

Share