Skrivefirmaet er et dansk freelancefirma med speciale i technical writing. Jeg hjælper software-, IT- og industrivirksomheder med teknisk dokumentation, dokumentationsprojekter, og AI-understøttet technical writing.
Skal det være lettere for dine kunder og brugere at finde svar? Skal det være lettere for dine medarbejdere at finde svar. De fleste IT- og industrivirksomheder har brug for velskrevet og velstruktureret teknisk dokumentation. Også hvis hjælpen kommer via en bot eller en agent.
Velstruktureret onlinehjælp og velorganiserede manualer hjælper dine brugere med hurtigt at finde svar på deres spørgsmål. Det giver kunderne en bedre oplevelse samtidig, at det aflaster supportafdelingen. Desuden kan en technical writer frigøre udviklere og ingeniører fra tidskrævende redigeringsarbejde, så de kan fokusere på deres kerneområde.
Hvornår har du brug for en technical writer?
Der er nogle situationer, hvor det typisk er en god idé at hente en konsulent ind:
- Din bot eller agent giver kunder og medarbejdere upræcise svar, fordi indholdet bag den er ustruktureret.
- Du skal lancere et nyt produkt og mangler dokumentation.
- Din eksisterende dokumentation er forældet.
- Dine udviklere bruger for meget tid på at skrive.
- Din supportafdeling får de samme spørgsmål igen og igen.
- Du skal migrere dokumentation fra ét system til et andet.
Hvordan bruger jeg AI i dokumentationsarbejdet?
Mange virksomheder forbinder AI og dokumentation med indhentning af information og skrivning af tekster. Det er en del af det. En anden vigtige del er at klargøre jeres dokumentation og andet indhold, så det er anvendeligt for de AI-værktøjer, I bruger internt og eksternt som fx botter og agenter.
AI – eller LLMs – ved ikke, hvordan dit produkt fungerer, eller hvad der er mest kritisk at få kommunikeret præcist og korrekt. AI ved heller ikke, hvad din målgruppe forstår. Det kræver en erfaren technical writer, der kan styre processen og kvalitetssikre indholdet.
Mange virksomheder har gode grunde til at være forsigtige med at introducere AI. Der kan være fortrolige produktoplysninger og interne sikkerhedspolitikker, som begrænser anvendelsen af AI. Det kan også betyde, at ikke alle værktøjer må anvendes. Jeg tilpasser mig jeres krav og arbejdsproces.
Hvad laver en technical writer?
En technical writer er meget andet end en skribent. Jeg omdanner kompleks, teknisk viden til klar, brugbar dokumentation. Ofte udfører jeg en kombination af nogle af disse opgaver:
- Strukturerer information og vælger de rette værktøjer, uanset om projektet starter fra bunden eller bygger videre på eksisterende dokumentation.
- Fungerer som teknisk forfatter eller teknisk redaktør på både små og store projekter.
- Skriver, redigerer og opdaterer dokumentation.
- Oversætter teknisk jargon til klart sprog. Og selvfølgelig med forståelse for at tekniske begreber og procedurer ikke bare kan ændres, fordi en tekst skal lyde bedre.
- Reviewer UI-tekster, så brugeroplevelsen er i overensstemmelse med resten af dokumentationen.
- Interviewer og indhenter viden fra udviklere, product owners, designere og andre eksperter.
Technical writer til planlægning, rådgivning, og implementering
Jeg har stor erfaring som projektleder og skribent på dokumentationsprojekter indenfor software (Web3, Defi, Saas, Blockchain), telekommunikation og industri. Jeg har løbende haft konsulentopgaver for bl.a. Concordium, Stibo Systems, G4S, Spectralink, og Rambøll.
Din virksomhed kan også få hjælp til at planlægge og gennemføre konverteringsprojekter, hvor dokumentation udarbejdet i fx FrameMaker, InDesign eller Word migreres til MadCap Flare.
Derudover arbejder jeg med Markdown, reStructuredText, VS Code og GitHub i forbindelse med docs-as-code projekter.
Hvilke typer af dokumentation?
- Online
- Manualer
- Onlinehjælp
- UI tekst
- User assistance
- Installation guides
- Read me’s
- Fact sheets
- Dataark
- Produktbeskrivelser
- Sproglig redigering
- Single sourcing
Hvilke tech writer værktøjer?
- Madcap Flare
- VS Code
- GitHub
- FrameMaker
- Word
- Bitbucket
- Forestry.io
- WordPress
- Umbraco
- Confluence
- Jira
Få mere at vide om Skrivefirmaet