Why the best person to write a manual is someone who doesn't know what they are doing!
16th of November 2024 (Business category) by Procubate Virtual Business School
I hear all the time, get the expert to write the manual, & it makes me cringe.
I'm not on about throwing them in the deep end alone without any help, or without some insight. I'm thinking about them writing it, perhaps gradually, by gathering the answers to all the right questions that they feel need to be asked.
I've met many Business Process Engineers, or Technical Authors over the years, & the reason they could be so good was because they could be objective, which no-one else truly could.
-
Avoids ambiguity or misunderstanding - It has to be written for a layman to read. The expert uses language that only experts understand. A layman will ask for explanation, and nothing is taken for granted. No stone is left unturned, and no expert level assumptions are made. Ever tried to ask a technical support person for help, and wish you'd never asked?
-
Avoids overlooking the obvious - An expert simply can't do this. They are too close that they struggle to get it in the right sequence, miss our steps, or make wild assumptions of what 'always happens', with no fallback plan for those times when it doesn't
-
Makes sure nothing is missed out - Imagine writing an instruction for something you never think about because it's second nature. How much harder is it to do right, than someone who 'doesn't get it' and needs to ask all the questions to make sure it makes sense and then puts down the steps that a layman needs to use to follow.
-
Helps newbies to learn properly - Someone learning the process should be curious about what the reader will need to know. Most experts don't make good teachers, and most teachers aren't experts, except perhaps in theory. The expert will never need this document. A newbie, or someone back from a break away will!
-
Fresh eyes bring a fresh perspective - The person doing it daily doesn't see shortcuts, alternatives, or other potentially better ways of doing it right. Tainted eyes really don't bring that fresh view that only a layman, ideally with some insight of the industry, can actually bring.
-
Makes sure nothing is taken for granted - If you miss a step, an expert could cope, but a newbie couldn't. Only a newbie can truly question what happens if something goes wrong, that an expert takes for granted.
-
It's extremely useful for a new-starter to do - A layman new starter can use this process to learn what is required, and come up to speed exponentially quicker than any other way. Nothing is gained by an expert writing it down, other than wasting the time of an expert. If a new-starter is taking notes for how to do things, it only makes sense to convert those notes into useful instructions, which can be checked together, with all gaps & questions answered!
-
Captures changes that are often overlooked - When a process changes, an expert rarely takes note of the change. Steps are overlooked, & old processes have a way of creeping back in
-
Avoids distracting the busy expert - That expert's time is valuable & in short supply, & that is often overlooked. They will need to have questions bounced off them, but to ask them to write it all up is often an expensive use of that person's valuable time and produces worse results!
-
Makes it ready for the future - Having an instruction manual written for a layman can then used in automation or be read by ChatGPT, Claud, Gemini, or other AI system, & forms a great framework for being able to ask it questions. Inputting an experts manual would only cause confusion & be a complete waste of time!
Disclaimer: Guest blogs are produced by independent bloggers, some of which are authorised to publish without further approval. Their expressed content may not represent Aurora's views, values or beliefs. Please contact us if you feel any content is inappropriate. To become a guest blogger, please contact us.