5.4IT documentation & procedures
Documentation is the least glamorous and most quietly decisive IT discipline. It comes in three families: infrastructure (how the network, servers and access are set up), procedures (step-by-step how-tos), and a knowledge base (problems and their solutions). Good documentation is vital for four reasons: continuity (the « bus factor » — the organization must not collapse if the one person who knows everything is unavailable), efficiency (reproduce and delegate work instead of reinventing it), security and recovery (you cannot rebuild what is undocumented), and growth (new people get productive faster).
The traps are as important as the benefits. A simple, current document beats an exhaustive, obsolete one — wrong documentation is worse than none, because it misleads. So keep it accessible, centralized, living and concrete, and above all keep it up to date. The single most effective habit is to document while you do, not « later » (which never comes): write the note as you make the change, capture the fix as you close the ticket. Do not aim for perfection or completeness; aim for the records your team actually relies on — critical systems, key contacts, recurring fixes, onboarding steps, recovery procedures. Documentation is how a team's knowledge stops living in one head and starts belonging to the organization.
Section vocabulary
- Infrastructure docs
- How the network, servers and access are configured.
- Procedures
- Step-by-step instructions for performing tasks reliably.
- Knowledge base
- A store of problems and their solutions, so fixes are reusable.
- Bus factor
- The risk that too much knowledge lives in one person; documentation reduces it.
- Document while you do
- Writing the note as you make the change, rather than 'later'.
Why is IT documentation vital?
In practice — Document what matters
- List the few records your team relies on most: critical systems, key contacts, recurring fixes, onboarding.
- Write one clear procedure for a routine task, concrete enough for someone else to follow.
- Add one knowledge-base entry from a problem you recently solved.
- Decide where docs live (central, accessible) and how they stay current as things change.
Key takeaways
- Three families: infrastructure, procedures, knowledge base.
- Vital for continuity (bus factor), efficiency, security/recovery, and growth.
- Simple and current beats exhaustive and obsolete — wrong docs mislead.
- Document while you do it, not 'later'; aim for the records your team truly relies on.
Frequently asked questions
We're busy fixing things — is documentation really worth the time?
It is, precisely because you are busy: undocumented IT makes every future problem slower and every absence dangerous. The value shows up as continuity when the person who knew how everything works is off or gone, as speed when a documented fix means you solve a recurring issue in minutes instead of rediscovering it, as safe recovery when you can rebuild a system because its setup is written down, and as smoother onboarding for new staff. The trick is to make it cheap: document while you work rather than as a separate project, and cover the records you actually rely on rather than everything. A little current documentation repays the time many times over; its absence is only free until the day it isn't.
What makes documentation good rather than just present?
Good documentation is simple, current, accessible and concrete — and, above all, trustworthy. The worst outcome is not missing documentation but wrong documentation, because it actively misleads someone into a bad action during an incident. So favour a short, accurate note over a long, stale one; keep everything centralized so people can find it; write concretely enough that another person can follow it without you; and update it as reality changes, ideally at the moment of the change. Don't chase exhaustiveness or perfect formatting — chase usefulness and accuracy for the things your team truly depends on. Living, honest, findable documentation is what turns individual know-how into organizational resilience.