Efter mer än 30 år av arbete med teknisk dokumentationen och materielpublikationer ser vi samma utmaningar återkomma i projekt efter projekt.

Gemensamt för dem är att de sällan handlar om själva dokumentationsarbetet. I stället handlar de om när arbetet startar, vilket underlag som finns och hur projektet planeras och följs upp.

Här är några av de vanligaste fallgroparna – och våra råd för att undvika dem.

1. Dokumentationen startar vid fel tidpunkt

Ett vanligt missförstånd är att dokumentation alltid startar för sent. I verkligheten är problemet ofta att den startar vid fel tidpunkt.

Om konstruktionen fortfarande utvecklas kan en alltför tidig produktionsstart innebära att stora delar av dokumentationen måste göras om. Samtidigt behöver vissa delar vara färdiga i god tid inför exempelvis tester, utbildning eller delleveranser.

I ett moget projekt med en färdig konstruktion kan dokumentationsarbetet däremot starta tidigt och löpa mycket effektivt.

Det finns därför ingen universell startpunkt. Dokumentationsarbetet behöver anpassas efter projektets mognad och delas upp så att rätt information produceras vid rätt tidpunkt.

2. Konstruktionen fortsätter förändras

I många projekt förändras konstruktionen samtidigt som dokumentationen produceras.

Det gäller särskilt nyutvecklade produkter och större modifieringar. Utmaningen är inte att förändringar sker, utan att de ibland inte kommuniceras eller hanteras tillräckligt strukturerat.

En tydlig förändringshantering och ett nära samarbete mellan konstruktion och dokumentation minskar risken för kostsamma omarbetningar.

3. Underlaget håller inte tillräcklig kvalitet

Det här är en av de vanligaste orsakerna till att dokumentationsprojekt blir dyrare än planerat.

Många projekt utgår från befintliga manualer, instruktioner eller ritningar som fungerar väl för sitt ursprungliga syfte, men som inte uppfyller de krav som ställs på en materielpublikation.

Det kan handla om inkonsekvent terminologi, fel bildstil, bristande struktur eller saknad information. När detta upptäcks sent krävs ofta omfattande omarbetningar.

Att kvalitetssäkra underlaget innan produktionen startar är en lönsam investering.

4. Illustrationsunderlaget räcker inte

Många utgår från att illustrationerna kan tas direkt från CAD-systemet.

I praktiken saknas ibland CAD-underlag. Då behöver nytt bildmaterial produceras från grunden, vilket påverkar både tidplan och budget.

Illustrationsbehovet bör därför identifieras redan i projektets planeringsfas.

5. Ritningarna stämmer inte med verkligheten

Även när ritningsunderlaget är komplett är det inte säkert att det speglar den färdiga materielen.

Komponenter kan ha flyttats och detaljer ändrats under projektets gång. Om dokumentationen produceras enbart utifrån ritningar finns en risk att den inte stämmer med den produkt som faktiskt levereras.

I många projekt behöver därför den färdiga materielen verifieras innan dokumentationen fastställs.

6. Ingen äger den tekniska kvaliteten

En återkommande utmaning är att det saknas en tydlig ansvarig för den tekniska granskningen.

Dokumentationen skickas mellan olika experter, men ingen har ett samlat ansvar för att innehållet är tekniskt korrekt innan det lämnas vidare till FMV.

Resultatet blir onödiga granskningskommentarer, fler korrekturvändor och längre ledtider.

En tydlig intern granskningsprocess med utsedda sakkunniga sparar både tid och kostnader.

7. Disciplin saknas i granskningsprocessen

Många projekt har en genomarbetad produktionsplan men en betydligt mindre tydlig plan för granskningen.

Den första granskningen blir ofta översiktlig och få synpunkter lämnas. När leveransen närmar sig kopplas fler personer in, granskningsnivån höjs och det kommer kommentarer på innehåll som egentligen borde ha granskats långt tidigare.

Problemet är sällan att synpunkterna är fel – tvärtom är de ofta helt relevanta. Problemet är att de kommer vid fel tidpunkt.

En väl fungerande granskningsprocess bygger på tydliga spelregler. Varje granskningsomgång ska ha ett tydligt syfte, rätt kompetens ska vara involverad från början och kapitel som är godkända ska inte öppnas igen om inte förutsättningarna faktiskt har förändrats.

Granskning handlar inte bara om att hitta fel – den handlar om att hitta rätt fel, vid rätt tillfälle.

8. Dokumentationen är en del av materielen – inte en bilaga

Den kanske största missuppfattningen i många projekt är att dokumentationen betraktas som något som levereras som en bilaga till materielen.

I praktiken är dokumentationen en del av materielen.

Ett avancerat system kan vara tekniskt perfekt, men utan korrekt dokumentation kan det inte användas, underhållas eller utbildas på ett säkert och effektivt sätt.

Försvarsmateriel ska dessutom ofta kunna användas och underhållas under flera decennier, ibland efter långa perioder i förråd. När materielen väl behöver tas i bruk måste både materielen och dokumentationen fungera.

Det är därför dokumentationen behöver planeras, finansieras och kvalitetssäkras på samma sätt som övriga delar av systemleveransen.

Att se dokumentationen som en integrerad del av materielen är inte bara en fråga om kvalitet – det är en förutsättning för långsiktig operativ förmåga.

Sammanfattning

De flesta problem i dokumentationsprojekt går att förebygga.

Gemensamt för de vanligaste fallgroparna är att de sällan handlar om själva skrivandet. De handlar om planering, samarbete, underlag och tydliga processer.

Genom att identifiera riskerna tidigt och ge dokumentationsarbetet rätt förutsättningar kan både ledtider, kostnader och omarbetningar minska avsevärt.