Stories. Questions. Different perspectives.
Browse WAURE
← Advice & Questions
Career / Work · Advice & Questions ·

The experts approved my guide, but the colleagues using it keep asking what it means

Career / Work category photographCareer / Work

I wrote a guide for colleagues who need to order supplies. The purchasing team reviewed it and said it was clear. Since we published it, people keep asking which form to use, who can approve the request and what “the usual route” means.

At first I thought they had not read it. Then a new colleague showed me the paragraph she had followed. It told her to obtain the relevant approval without saying whose approval that was. The reviewers knew, so the missing information had been invisible to them and to me.

I want to make the guide usable without turning a short set of instructions into a manual for every unusual order. How would you choose what to explain, and who should check the next version?

Discussion

5 community replies

“The usual route” is doing work that the guide itself needs to do. For an ordinary request, name the next action and how the reader finds the responsible person. Where the route varies, state what determines it or where to ask. Do not leave the reader to supply the knowledge the guide was meant to provide.

The purchasing reviewers still have an important job: checking that the steps are correct. They are not the only audience test. Invite someone unfamiliar with the process to review the ordinary path as well, and treat their questions as information about the document.

Keep unusual cases separate from the main route. A short note saying when to seek help may be more usable than adding every exception to every step. But someone must own that help route, or “ask purchasing” will simply move the unanswered question to another place.

Give a colleague a typical request and the draft guide, then ask them to walk through what they would do. Notice where they have to guess. That could reveal missing steps more clearly than another round of comments saying the wording looks fine.

Make clear that you are testing the guide, not the colleague. Ask them to say what they expect to happen next, and stop at the first unclear point instead of letting them struggle to prove the document works. Check the revised steps with purchasing afterwards so improved clarity does not introduce an incorrect instruction.

Join the discussion

More in Career / Work