Så arbetar jag med dokumentation och ordning i IT-miljön så att inget faller mellan stolarna
När man pratar om IT tänker många först på nätverk, datorer, servrar, säkerhet och support. Det är förståeligt. Det är ofta de delarna som syns mest i vardagen.
Men en av de viktigaste delarna i en välfungerande IT-miljö är något som inte alltid märks direkt när allt fungerar: dokumentation och ordning.
För mig är det en självklar del av ett professionellt arbetssätt.
Jag tycker inte att dokumentation bara är “något man borde ha”. Jag tycker att det är en del av kvaliteten. Det gör arbetet tydligare, tryggare och lättare att följa upp. Framför allt minskar det risken att viktig information bara finns i huvudet på en person.
Jag vill att miljön ska gå att förstå
När jag kommer in i en IT-miljö vill jag kunna förstå hur allt hänger ihop.
Vilka system finns? Hur ser nätverket ut? Vilka servrar är viktigast? Var finns backup? Hur ser användarhanteringen ut? Vilka leverantörer används? Vilka licenser finns? Vem har ansvar för vad?
Om svaren på de frågorna inte finns samlade någonstans blir miljön snabbt mer sårbar än den behöver vara. Då blir varje felsökning tyngre, varje förändring osäkrare och varje överlämning svårare.
Jag vill därför skapa en miljö som går att läsa av, inte bara använda.
Dokumentation gör det lättare att ge bra support
En stor fördel med bra dokumentation är att supporten blir bättre.
Om någon hör av sig med ett problem går det mycket snabbare att hjälpa till om man redan vet hur miljön är uppbyggd. Om det finns en tydlig bild av nätverket, vilka system som används, hur användare är organiserade och vilka lösningar som redan finns på plats, då slipper man börja om från noll varje gång.
Det sparar tid både för användaren och för den som hjälper till.
Jag tycker också att det skapar lugn. När det finns ordning i informationen blir arbetet mindre stressigt, särskilt när något behöver lösas snabbt.
Jag dokumenterar det som faktiskt är viktigt i vardagen
För mig handlar dokumentation inte om att skriva så mycket som möjligt. Det handlar om att dokumentera det som faktiskt gör nytta.
Det kan till exempel vara:
Jag vill att dokumentationen ska vara praktisk. Den ska hjälpa i vardagen, inte bara finnas där för att den “ser bra ut”.
Jag tycker om ordning även i det lilla
Ordning i IT-miljön handlar inte bara om stora dokument. Det handlar också om små detaljer.
Jag tycker till exempel om när:
Det här kanske inte alltid låter stort, men det gör mycket i praktiken. När miljön är tydlig blir den mycket enklare att arbeta i, underhålla och förbättra.
Jag vill inte att viktig kunskap ska sitta hos bara en person
En av de största riskerna i många IT-miljöer är att för mycket kunskap sitter hos en enda person.
Kanske vet en person hur backupen fungerar. Kanske vet en annan hur brandväggen är uppbyggd. Kanske vet bara en viss person hur en viktig server är konfigurerad. Så länge allt fungerar märks det kanske inte. Men när någon är borta, byter roll eller slutar blir det snabbt ett problem.
Därför tycker jag att dokumentation också är en fråga om trygghet. Kunskap ska inte vara låst till en person. Den ska gå att dela, förstå och följa upp.
Dokumentation gör förändringar säkrare
När man ska göra ändringar i en miljö är dokumentation extra viktig.
Om jag vet hur nätverket ser ut, vilka beroenden som finns och vad som redan är gjort, då kan jag göra förändringar mer kontrollerat. Jag kan också lättare bedöma vad som kan påverkas och vad som behöver testas.
Utan den typen av ordning är risken större att man gör en ändring som får oväntade följder. Och det är ofta där små problem blir större än de behöver bli.
Jag tycker därför om att dokumentera både nuläge och förändringar. Vad ändrades, varför ändrades det och när gjordes det? Det gör att man kan följa miljön över tid.
Jag vill att det ska vara lätt att följa upp
Bra ordning gör det också lättare att följa upp sådant som annars lätt glöms bort.
Det kan handla om:
När det finns struktur blir det mycket enklare att arbeta långsiktigt. Då slipper man ta allt på känsla eller leta fram information varje gång något behöver följas upp.
Jag tycker att dokumentation ska vara enkel att läsa
Jag vill inte att dokumentation ska kännas som en tung rapport som ingen orkar öppna. Jag tycker att den ska vara tydlig, enkel att läsa och lätt att hitta i.
Det betyder att jag gärna arbetar med klara rubriker, enkel struktur och språk som går att förstå. Det ska vara tydligt vad som finns dokumenterat och var man hittar det man behöver.
Ju enklare det är att använda dokumentationen, desto större chans att den faktiskt blir använd.
Jag ser dokumentation som en del av ett respektfullt arbetssätt
För mig handlar dokumentation också om respekt för kunden och för dem som ska arbeta vidare i miljön.
När jag dokumenterar visar jag att jag tar arbetet på allvar. Jag visar att jag inte bara vill lösa något för stunden, utan också lämna efter mig något som går att bygga vidare på.
Det gör också att kunden känner större trygghet. De vet att miljön inte bara fungerar idag, utan att det finns ordning som hjälper även framåt.
Målet är att inget ska falla mellan stolarna
Det jag vill uppnå med dokumentation och ordning är egentligen ganska enkelt. Jag vill att inget viktigt ska falla mellan stolarna.
Jag vill att det ska vara tydligt vad som finns, hur det fungerar, vad som behöver följas upp och vem som gör vad. Jag vill att supporten ska bli lättare, att förändringar ska bli tryggare och att verksamheten ska stå stadigare även om något oväntat händer.
Det är då dokumentation blir mer än bara anteckningar. Då blir den en del av hur man bygger en hållbar IT-miljö.
Så vill jag arbeta med dokumentation och ordning
Jag vill arbeta med dokumentation på ett sätt som gör vardagen enklare, inte tyngre. Jag vill skapa struktur som hjälper både kunden och den som arbetar med miljön. Jag vill att information ska vara tydlig, användbar och lätt att följa upp.
För mig är det ett tecken på bra IT-arbete när saker inte bara fungerar, utan också är lätta att förstå.