Go to main content

Därför skapar manuella arbetsflöden för lokalisering kaos för dokumentationsteam

Julianna Carlson-van Kleef

Man sitting at a desk, working on his computer

Teknisk och regulatorisk dokumentation hanteras i dag av flera team och i flera system

Teknisk dokumentation hanteras i dag sällan i ett enda system eller av ett enda team. I många organisationer skapas, hanteras och publiceras teknisk information i flera olika system och team.

Vilken typ av innehåll som dokumenteras påverkar också hur informationen hanteras och lokaliseras. Dokumentation för hårdvara, digitala hjälpcenter och hybrida produktekosystem hanteras ofta på olika sätt och innebär olika krav och utmaningar vid publicering och lokalisering.

Läs om varför olika typer av dokumentation kräver olika lokaliseringsflöden

Team med tekniska skribenter

kan ansvara för strukturerad produktdokumentation, underhållsguider, bruksanvisningar (IFU:er) och produktdatablad.

Produktmarknads- och säljteam

skapar ofta kundnära tekniskt innehåll, till exempel broschyrer, säljpresentationer, white papers, produktblad och lösningsöversikter som ska kommunicera produktfunktionalitet och affärsvärde.

Support- och onboardingteam

kan ansvara för onboardingguider, implementeringsdokumentation, felsökningsinnehåll och flerspråkiga artiklar i kunskapsdatabaser.

Team med mjukvaruutvecklare

kan hantera UI-text, versionsinformation och utvecklardokumentation kopplad till releasecykler.

I organisationen sprids teknisk produktinformation ofta mellan:

  • CMS-system,

  • CCMS-system,

  • PIM-system,

  • ERP-plattformar,

  • kunskapsdatabaser,

  • supportportaler och

  • utvecklingsrepo.

I dessa miljöer kan innehåll finnas både i strukturerade format som XML eller DITA och i ostrukturerade format som Word-dokument, PDF-filer, kalkylblad, presentationer och layoutbaserade publikationer.

Tillsammans gör systemen det möjligt att skapa, uppdatera, återanvända och distribuera teknisk information på globala marknader.

Vad händer när lokaliseringsflöden kopplas bort från varandra?

Lokalisering behandlas ofta som något som sker efter att innehållet redan har skapats på originalspråket. I många organisationer läggs översättningsprocesser ovanpå befintliga innehållsflöden i stället för att byggas in direkt i dem.

Till en början försöker team ofta hantera dessa processer manuellt. Dokumentation kan exporteras från innehållssystem, kopieras till kalkylblad, skickas mellan team via e-post eller delas med översättningsleverantörer som fristående filer. Designteam kan manuellt kopiera och klistra in översatt text i layouter för språk de själva inte behärskar. Webbteam kan ladda upp översatt innehåll sida för sida i CMS-plattformar, medan supportinnehåll uppdateras separat i flera olika kunskapsdatabaser.

Den här typen av arbetssätt kan kännas hanterbar i början, men komplexiteten växer snabbt när innehållet sprids över flera språk, produktvarianter, mjukvaruversioner och publiceringskanaler.

Det som börjar som en enkel export-och-översätt-process utvecklas ofta snabbt till fragmenterade arbetsflöden med:

  • duplicerat innehåll

  • problem med versionshantering

  • formateringsproblem

  • återkommande manuella moment

  • koordinering mellan flera team, verktyg och språk.

När mängden flerspråkig dokumentation växer kan frånkopplade lokaliseringsprocesser skapa flaskhalsar som fördröjer uppdateringar, ökar det manuella arbetet och gör flerspråkig kommunikation betydligt svårare att skala upp.

Förlust av kontext

Teknisk information existerar sällan i ett vakuum. En kort instruktion i en underhållsguide kan bygga på tidigare steg i processen. En UI-etikett kan vara beroende av omgivande gränssnittselement. En teknisk varning kan hänga ihop med säkerhetsinstruktioner någon annanstans i dokumentationen.

När material exporteras till fristående filer tappar översättare ofta insyn i hur informationen passar in i det större arbetsflödet.

Även enkla formuleringar kan bli tvetydiga utan den kontexten. I en mjukvarumiljö kan till exempel formuleringen ”Check the logs” syfta på systemloggar. Utan kontext skulle det lika gärna kunna tolkas som att kontrollera fysiska loggar eller register.

Små tvetydigheter som dessa kan leda till felaktiga översättningar, särskilt i tekniska och regulatoriska miljöer där terminologin är mycket specialiserad.

Säkerställ enhetlig terminologi på alla språk med centraliserad termdatabashantering

Bristande återanvändning och dubbelarbete

Många dokumentationsmiljöer bygger i hög grad på återanvändning av innehåll.

Samma instruktion kan förekomma i flera bruksanvisningar, mjukvaruversioner eller supportartiklar. I strukturerade miljöer hanteras återanvändning ofta automatiskt genom återanvändbara innehållsmoduler.

Även i mindre strukturerade miljöer behöver organisationer kunna upprätthålla enhetlighet och minska dubbelarbete i flerspråkigt innehåll.

Översättningsminnen och termdatabaser hjälper team att återanvända godkända översättningar, standardisera terminologi och skapa enhetlighet mellan avdelningar, produkter och innehållstyper.

När innehåll separeras från sina ursprungliga arbetsflöden blir det däremot svårare att bevara kopplingar mellan återanvänt innehåll och hantera översättningsresurser effektivt.

Resultatet blir att identiskt eller nästan identiskt innehåll översätts om och om igen mellan olika projekt, vilket ökar kostnaderna, fördröjer uppdateringar och skapar oenhetlighet mellan språk.

Skapa enhetlighet mellan språk och undvik att översätta samma innehåll flera gånger

Problem med formatering och layout

För team som arbetar med bruksanvisningar, datablad, presentationer, regulatorisk dokumentation, flerspråkiga PDF-filer eller kundnära produktmaterial kan enhetlig formatering snabbt bli en stor utmaning.

Teknisk och regulatorisk dokumentation bygger ofta på strukturerade layouter, tabeller, diagram, fasta mallar och flerspråkiga formateringskrav som kan vara svåra att behålla mellan olika språkversioner. Kundnära material som broschyrer, säljpresentationer och produktblad kan dessutom innebära ytterligare krav kopplade till varumärke och design som kräver noggrann flerspråkig formatering.

Manuella export- och importflöden leder ofta till formateringsförändringar som senare måste korrigeras manuellt.

För flerspråkig dokumentation innebär det ofta ytterligare DTP-arbete efter översättning, där layouter, tabeller, sidformat och expanderad text behöver justeras för att innehållet ska fungera på olika språk och i olika format.

Effektivisera arbetet med layout, formatering och anpassning till olika textlängder på flera språk

Komplex versionshantering

Teknisk information förändras ständigt.

Nya produktversioner kräver uppdaterade instruktioner. Mjukvarureleaser genererar ny UI-text och nya versionsanteckningar. Regulatoriska förändringar kräver uppdaterad dokumentation för flera marknader och språk.

När dokumentation väl delas upp i filer för lokalisering blir det betydligt svårare att hålla käll- och målversioner synkroniserade.

Team kan behöva spåra versioner i kalkylblad, e-posttrådar, delade mappar, repo och frånkopplade system, vilket skapar ytterligare komplexitet i varje releasecykel.

Ta hjälp av en expert för att förbättra era lokaliseringsflöden

De dolda kostnaderna med frånkopplad lokalisering

När flerspråkiga innehållsflöden växer kan frånkopplade lokaliseringsprocesser skapa ineffektivitet långt utanför själva översättningsarbetet. Manuell koordinering mellan dokumentation, produkt, support och utveckling kan med tiden skapa omfattande administration.

Tekniska skribenter, lokaliseringsansvariga och team för innehållshantering kan behöva lägga allt mer tid på att samordna uppdateringar i stället för att förbättra innehållskvalitet och användarupplevelse.

I större skala stöter organisationer ofta på utmaningar som:

  • fördröjda dokumentationsuppdateringar till följd av översättningskoordinering

  • dubbelarbete mellan team och språk

  • ökat arbete med DTP och formatering

  • långsammare releasecykler för produkter och mjukvara

  • ökad administrativ belastning mellan distribuerade team

  • svårigheter att upprätthålla enhetlighet mellan språk, avdelningar och kanaler.

När lokaliseringen blir mer komplex kan frånkopplade processer bli en flaskhals som bromsar innehållsflöden, driver upp kostnader och gör det svårare att skala flerspråkig kommunikation.

För att hantera dessa utmaningar söker organisationer allt oftare sätt att koppla lokalisering närmare de system och arbetsflöden som olika team redan använder.

Skala flerspråkigt innehåll mellan sammankopplade system

När organisationer växer behöver lokaliseringsprocesser kunna hantera ökad komplexitet utan att alla team måste arbeta i samma översättningsflöde.

I stället bygger skalbara lokaliseringsprocesser allt mer på att flera olika arbetsflöden, system och innehållsformat kan fungera tillsammans utan omfattande manuell koordinering.

För att förbättra skalbarheten och minska fragmenterade arbetsflöden använder organisationer ofta en kombination av:

  • strukturerade innehållsflöden

  • översättningsplattformar

  • terminologihantering

  • teknologi för översättningsminnen

  • DTP-support

  • automatisering

  • integrerade systemkopplingar.

I stället för frånkopplade export- och översättningsflöden vill organisationer i allt högre grad behålla kopplingen mellan flerspråkigt innehåll och de system där innehållet skapas, uppdateras och publiceras.

Koppla lokalisering till teamens befintliga arbetsflöden

Många organisationer går mot lokaliseringsprocesser som är direkt kopplade till innehållssystem och publiceringsmiljöer.

Det kan till exempel innebära att:

  • team med tekniska skribenter använder XML-baserade arbetsflöden och CCMS-integrationer som MadCap IXIA CCMS

  • utvecklingsteam kopplar repo-baserade lokaliseringsflöden till Git-miljöer och releasepipelines

  • team för produktkommunikation  lokaliserar kundnära tekniskt innehåll genom integrationer med CMS, PIM, e-handel eller Adobe Experience Manager (AEM)

  • supportteam kopplar flerspråkiga arbetsflöden direkt till kunskapsdatabaser och supportplattformar som Zendesk

  • strukturerat innehåll och metadata bevaras genom hela lokaliseringsprocessen

  • filhantering, projektskapande, formateringsflöden och flerspråkiga uppdateringscykler automatiseras genom kopplingar och API:er.

När lokalisering är kopplad till befintliga system kan team fortsätta arbeta i de verktyg de redan använder, medan flerspråkiga uppdateringar hanteras som en del av det ordinarie publiceringsflödet.

Koppla lokalisering direkt till de system som era team redan använder

Koppla lokalisering till teamens befintliga arbetssätt

Många organisationer förlitar sig fortfarande på manuella exporter, frånkopplade arbetsflöden och filbaserade lokaliseringsprocesser för att hantera flerspråkigt tekniskt och regulatoriskt innehåll.

Men i takt med att innehållsflöden sprids över fler team, system och releasecykler blir den här typen av arbetssätt snabbt svåra att skala upp.

Moderna lokaliseringsflöden blir allt oftare en integrerad del av det bredare innehållsekosystemet och kopplar samman dokumentationsplattformar, repo, supportsystem, produktmiljöer och översättningsflöden.

Med rätt integrationer, automatisering och arbetsflöden kan organisationer minska behovet av manuell koordinering, bevara innehållets struktur och enhetlighet samt hålla flerspråkiga uppdateringar synkroniserade med produkt- och releasecykler.

Organisationer som vill göra dokumentations- och lokaliseringsflöden mer skalbara kan få hjälp av våra specialister att utvärdera nuvarande lösningar, identifiera var frånkopplade arbetsflöden skapar onödig administration och undersöka integrationsmöjligheter som passar befintliga arbetssätt.

Rådgör med en expert på lokalisering av teknisk dokumentation

Gör din dokumentation lokaliseringsklar från dag ett

Minska efterarbete, undvik undantag och säkerställ en trygg lansering på alla marknader.