Documentation
specialist
Runbooks written, client environments documented, diagrams kept current and knowledge extracted from your engineers' heads — the single thing standing between your MSP and its next ten clients.
MSPs scale on documentation, and it never gets written
Every MSP owner knows the constraint and can name it precisely: too much of the environment lives in one or two engineers' heads. Onboarding a new engineer takes months. Holidays are stressful. A resignation is a genuine business risk.
Documentation is the fix and it never happens, because the person who could write it is billable and documentation is not. It is always next month.
A documentation specialist is the answer specifically because they are not billable. Their entire job is extracting what your engineers know and turning it into something a new starter could follow — and unlike your engineers, they will actually do it.
What they produce
- Runbooks — Step-by-step procedures for recurring tasks, written from engineer walkthroughs and tested by someone who was not there — which is what makes them actually usable.
- Client environment documentation — Per-client notes: infrastructure, identity, applications, integrations, quirks, and the thing that always breaks.
- Network and system diagrams — Diagrams built and kept current as environments change, rather than drawn once at onboarding and never touched.
- Standard operating procedures — Your internal processes — onboarding, offboarding, escalation, change — written down and versioned.
- Knowledge base articles — Client-facing and internal articles for the questions that recur, so the same answer is not retyped weekly.
- Documentation audits — Gaps identified against your client list, so you know what is undocumented before a resignation tells you.
- Onboarding packs — New-client and new-engineer packs assembled from the documentation set.
- Change log upkeep — Environment changes captured as they happen, so documentation stops drifting from reality.
Where the line sits
Writing and structuring travel. Technical decisions and production access do not.
- Technical decisionsWhat the architecture should be, or how something should be configured, is your engineers' call. They document it.
- Production accessDocumentation rarely needs write access. Scope to read-only where your tooling allows.
- Credential storageDocumenting that a credential exists is different from holding it. Password vault access should be scoped tightly or excluded.
- Client-facing technical adviceKnowledge base articles are reviewed by an engineer before publication.