Een documentatiebeleid voor je Workspace-configuratie zorgt dat kennis behouden blijft, ook als een beheerder vertrekt. Veel configuraties zitten in het hoofd van een persoon. Vertrekt die, dan staat de opvolger voor een raadsel. In dit artikel laten we zien hoe je een documentatiebeleid opstelt dat dit voorkomt.
Waarom documentatie geen luxe is
Stel dat de beheerder die de Workspace heeft ingericht vertrekt. De nieuwe beheerder kijkt naar de instellingen en vraagt zich af waarom extern delen beperkt is, waarom een bepaalde organisatie-eenheid bestaat en wat die ene mailroutering doet. Zonder documentatie is elk antwoord giswerk, en aanpassen wordt gevaarlijk omdat niemand de gevolgen kent.
Documentatie lost dit op. Het legt niet alleen vast wat de configuratie is, maar ook waarom. Dat waarom is vaak waardevoller dan het wat, want het wat kun je terugvinden in de console, maar het waarom zit alleen in iemands hoofd.
Leg het waarom vast, niet alleen het wat
De beste documentatie legt de redenen achter keuzes vast, niet alleen de keuzes zelf. Dat extern delen beperkt is, zie je in de console. Waarom het beperkt is, en welk incident of beleid daartoe leidde, staat nergens tenzij je het opschrijft. Juist die context voorkomt dat iemand later onbedoeld een belangrijke instelling terugdraait.
Wat je moet documenteren
Niet alles hoeft gedocumenteerd, maar de kern wel. De volgende onderwerpen horen in je configuratiedocumentatie.
| Onderwerp | Wat je vastlegt |
|---|---|
| Beveiliging | Tweestapsverificatie, wachtwoordbeleid en toegangsregels, met de reden erachter |
| Structuur | Organisatie-eenheden, groepen en waarom ze zo zijn ingedeeld |
| Beleidskeuzes | Deelbeleid, app-toegang en andere bewuste keuzes met motivatie |
| Procedures | Onboarding, offboarding, escalatie en noodprocedures |
| Integraties | Koppelingen met andere systemen en hoe ze werken |
Documenteer ook de toegang zelf: wie de super admins zijn, wie welke gedelegeerde rol heeft, en waar het noodherstelaccount staat. Deze informatie is cruciaal en mag niet alleen in iemands hoofd zitten.
Zet geen geheimen in gewone documenten
Wees voorzichtig met het documenteren van wachtwoorden en geheimen. Zet nooit gevoelige inloggegevens in een gewoon document dat breed gedeeld wordt. Gebruik daarvoor een goed beveiligde wachtwoordmanager of kluis. De documentatie verwijst naar waar het geheim staat, maar bevat het zelf niet.
Waar en hoe je het bewaart
Documentatie die niemand kan vinden, helpt niet. Bewaar het centraal, op een plek die de beheerders kennen en kunnen bereiken, ook als de hoofdbeheerder er niet is. Een Google Site of een gedeelde Drive werkt goed, omdat het meegroeit en versiebeheer biedt.
Een documentatiebeleid opzetten
- Bepaal welke onderwerpen je documenteert, minimaal beveiliging, structuur, beleid en procedures.
- Kies een centrale, beveiligde plek waar alle beheerders bij kunnen.
- Leg per onderwerp niet alleen het wat maar ook het waarom vast.
- Bewaar geheimen apart in een wachtwoordmanager en verwijs ernaar.
- Wijs iemand aan die verantwoordelijk is voor het actueel houden.
- Plan een vaste review, bijvoorbeeld elk kwartaal, om verouderde informatie bij te werken.
Documentatie actueel houden
Het grootste gevaar van documentatie is dat ze veroudert. Verouderde documentatie is soms erger dan geen documentatie, omdat ze vals vertrouwen geeft. Iemand handelt op basis van een document dat niet meer klopt en maakt daardoor een fout.
Koppel bijwerken aan elke wijziging
Maak documentatie bijwerken onderdeel van het wijzigingsproces. Verander je een belangrijke instelling, dan hoort het bijwerken van de documentatie bij die wijziging, niet als losse taak achteraf. Door het te koppelen aan de wijziging zelf, blijft het automatisch actueel en vergeet je het niet.
Verdeel de verantwoordelijkheid duidelijk. Zo voorkom je dat documentatie niemands taak is en daardoor blijft liggen.
| Rol | Verantwoordelijkheid |
|---|---|
| Beheerder | Documenteert eigen wijzigingen direct: wat en waarom. Houdt de operationele documentatie en procedures actueel. |
| IT-manager | Stelt het documentatiebeleid op en bewaakt naleving. Wijst de verantwoordelijke aan en plant de periodieke reviews zodat documentatie niet sluipend veroudert. |
Veelgestelde vragen
Hoe gedetailleerd moet documentatie zijn?
Gedetailleerd genoeg dat een nieuwe beheerder de configuratie begrijpt zonder de vorige te kunnen vragen. Leg de belangrijke keuzes en hun reden vast. Je hoeft niet elke triviale instelling te beschrijven, wel de bewuste en gevoelige.
Waar bewaar ik de documentatie het best?
Op een centrale, beveiligde plek die alle beheerders kennen en kunnen bereiken, ook bij afwezigheid van de hoofdbeheerder. Een gedeelde Drive of Google Site werkt goed dankzij versiebeheer en toegankelijkheid.
Moet ik wachtwoorden documenteren?
Niet in gewone documenten. Geheimen horen in een beveiligde wachtwoordmanager of kluis. De documentatie verwijst naar waar het geheim staat, maar bevat het zelf niet, om lekken te voorkomen.
Hoe voorkom ik dat documentatie veroudert?
Koppel het bijwerken aan het wijzigingsproces zelf en plan periodieke reviews. Wijs iemand aan die eindverantwoordelijk is. Documentatie die niemand bijhoudt, veroudert altijd en wordt dan een risico in plaats van een hulp.
Wie moet de configuratiedocumentatie kunnen inzien?
Alle beheerders die met de Workspace werken, plus een aangewezen eindverantwoordelijke. Beperk schrijfrechten tot wie wijzigingen mag doorvoeren, maar zorg dat leesrechten breed genoeg zijn dat niemand afhankelijk is van één persoon.
Lees ook een Acceptable Use Policy en de admin-checklist voor de aansluitende onderwerpen.