En teamhåndbog bør hjælpe nogen med at udføre en opgave, ikke blot bevise, at der findes et dokument. Start med én tilbagevendende procedure og en læser, der ikke har lært jeres interne ordforråd.
Vælg et harmløst eksempel: at forberede de godkendte filer til en workshopsession. Målet er en tydeligt identificeret pakke, ikke en beskrivelse af alt, hvad virksomheden laver.
Definér sidens opgave
Skriv, hvem der bruger siden, hvad de har brug for, før de starter, og det synlige resultat. Hold én procedure på siden, medmindre tæt forbundne handlinger skal forklares sammen.
Brug denne struktur:
Formål: forbered de godkendte workshopmaterialer. Før start: adgang til den aktive mappe og sessionens identifikator. Handlinger: find, undersøg, saml og overdrag filerne. Afslutning: modtageren kan identificere den rigtige pakke. Ejer: den person, der godkender ændringer i denne procedure.
Forklar den skjulte viden
Hold øje med begreber, som kun erfarne kolleger forstår. Angiv den faktiske placering eller beslutningsregel i stedet for at skrive “brug den sædvanlige fil”. Hvis et trin kræver tilladelse, så forklar, hvem der kan give den.
Knyt skærmbilleder til softwareversionen og gennemgangsdatoen. Et billede hjælper, når det viser noget, læseren skal kunne genkende; det erstatter ikke en beskrivelse af handlingen.
Gør opdateringer ansvarlige
Giv siden en ejer, en godkendelsesstatus og en anledning til gennemgang. En procedure kan have brug for at blive tjekket, når et værktøj ændres, eller når virksomheden ændrer sin proces. Notér, hvad den nye version erstatter.
Hvis siden indeholder uafklarede spørgsmål, så markér dem synligt. Lad ikke et udkast se godkendt ud blot for at holde håndbogen ryddelig.
Prøv en øvelse med en nyankommen
Giv siden til en person, der ikke kender opgaven, og lad vedkommende arbejde med sikre eksempelfiler. Guid dem ikke igennem hvert skjult trin. Notér, hvor de tøver, stiller et spørgsmål eller vælger den forkerte fil.
Brug disse observationer til at forbedre instruktionerne, og gentag den berørte del. En håndbog bliver nyttig gennem denne kontrol og vedligeholdelse. Den behøver ikke at påstå, at al virksomhedens viden automatisk gennemsøges eller holdes opdateret af AI.
Mika er et redaktionelt pseudonym, som bruges af KENJTEC-redaktionen i Hamburg. Denne artikel foreslår en arbejdsgang; den rapporterer ikke om en gennemført test.
