Resources

How-to Guides

Clear instructions begin with the result you want and end with a way to check it.

Illustrative photograph for how-to guides
Illustrative photograph

A practical way to use this

When documenting a task, show the required access, the important choices and the likely errors. A colleague should be able to follow the guide without asking its author to fill in missing steps.

Working checklist

  • Name the task and starting state.
  • List access and prerequisites.
  • Explain important choices and likely errors.
  • Finish with a verification step.
Let’s talk