HOW DETAILED SHOULD KNOWLEDGE DOCUMENTATION BE IN PRODUCTION?

“If I really have to write everything down, I’ll never get finished!” – Anyone who has dealt with corporate knowledge management knows this problem. At the same time, one often hears the complaint: “Even the simplest things are not done correctly!”

So how can you find the right level of detail in knowledge documentation despite these conflicting requirements?

Free yourself from outdated assumptions and focus on your target audience! With the following tips, you can achieve noticeably higher production efficiency and fewer unplanned downtimes in your manufacturing – even with changing or inexperienced machine operators.

Common False Assumptions in Knowledge Documentation

“If I write down everything in detail, at least mistakes won’t happen.”

Humans are not computers that reliably execute every line of code. Our short-term memory can store a maximum of 6–7 pieces of information. Try it yourself by having someone tell you phone numbers of different lengths and try to remember them. Especially when people need to combine several pieces of information and keep them in mind at the same time, they quickly reach their limits.

In addition, we are evolutionarily conditioned to achieve necessary results with the least possible effort (energy use). Some call this laziness; at the same time, it is often the source of creative solutions. Either way, once knowledge entries reach a certain length, our brain evaluates the shorter time of “just trying” – even with lower probability of success – as the better option. As a result, overly detailed documentation often goes unread.

“With reasonable people, you can assume quite a lot and don’t need to write everything down.”

Unfortunately, this assumption cannot be applied universally. The human brain is very good at associating. Basic knowledge we already have can easily be transferred to similar things or situations. Someone who can drive a car will probably manage a tractor relatively quickly, and the switch from Windows 7 to Windows 11 succeeds because we can connect it to existing knowledge.

It’s different when the basic knowledge and the mental models associated with it are completely missing. Someone who has never worked in automated production will be overwhelmed even by small problems. Nothing is generally “logical” or “intuitive” – access is always associative. This principle is largely independent of intellect. When people “act dumb,” what they usually lack is the necessary basic knowledge.

Therefore, you need to identify the overlap in basic knowledge within your target group to decide what you can assume and thus don’t need to document. A useful indication is often a person’s professional background. If you want to support a former baker or a former nurse working at a thermoforming machine, you will probably need more detailed documentation than with trained automotive mechanics.

Especially in times of staff shortages, companies are onboarding people from different backgrounds. That makes structured knowledge management more critical than ever.

How to Document for Your Target Group

At the beginning, it is rarely easy to judge what must be documented and what not – but it can be learned. One fundamental difficulty is that we often no longer remember our own process of acquiring knowledge and the challenges that came with it.

The key therefore lies in observing your target group in the following steps:

How to Improve Knowledge Documentation – Especially for Inexperienced Machine Operators

  1. Start Small

 Write a small number (5–10) of knowledge entries on the most frequent/relevant topics. Choose the level of detail intuitively, based on your knowledge of the target group. Lower your expectations a little and settle for about 80% completeness at the start (Pareto principle).

  • Test the System in Practice

 Introduce the knowledge management system as a trial in practice and communicate about it.

  • Use Questions as Feedback

 In most cases, your colleagues will not yet use the new system as intended and will still turn to you as an experienced person if you are nearby. Use this by referring them to the relevant knowledge entry and “staying close for further questions.” This way you achieve three things:

  1. You lower barriers, because you are still available if questions arise.
  2. Colleagues learn: “If I ask a question about something that’s in the new knowledge management system, I’ll be referred to it anyway. So I might as well use it first.” Over time, this shapes the habit of using the system.
  3. You can observe how the target group uses the documented knowledge without them feeling observed. This lets you learn exactly where more or less detail is needed for optimal usability.

This approach may sound simple, but after just a few iterations it will bring you much closer to the goal of an effective and actively used knowledge management system for your production.

A Smart Solution: MADDOX

In many production companies, the same scenario repeats itself: disruptions occur, costs rise, and at the same time staff shortages put additional pressure on the team.

When a disruption happens, operators search for the cause – but even the best database often fails to solve the problem. Why? Because in order to use knowledge from a traditional database, you need to know and apply the right keywords. And that’s exactly what is often missing: the correct name of a component or a type of disruption. As a result, the root cause remains hidden, and valuable time is lost.

This is where MADDOX comes in – our digital colleague. Instead of laboriously searching for keywords, MADDOX compares the current data patterns of the disruption with historical data and knowledge entries that the machine learning algorithm has been trained on. It then directly suggests the most relevant knowledge card containing a concrete solution for the current disruption. In this way, machine downtime is reduced without losing valuable time in fruitless searches.

MADDOX is the result of years of research and close collaboration with psychologists. A well-known challenge in production is that experienced employees often share their knowledge only reluctantly, because they feel their contributions are not properly recognized. MADDOX changes this dynamic: when operators solve a disruption and create a knowledge card from it, they immediately see that their contribution helps colleagues across the shop floor. This direct feedback creates appreciation and motivation – knowledge is shared more willingly.

Step by step, this builds a living knowledge management system that makes the entire operation more resilient, even with changing or inexperienced machine operators.

You can book a free expert consultation with the founders of Peerox to learn in detail how MADDOX can help reduce downtimes and efficiently increase OEE.

https://peerox.de