Sådan versionsstyrer du et dokument

Sådan fungerer det

1. Vælg jeres regel for decimaler over for hele tal

   Beslut skriftligt, at et udkast i review bærer et decimaltal (0.1, 0.2, 0.3), og en udstedt kopi bærer et helt tal (1.0, 2.0). Det præcise system betyder mindre end, at hvert dokument bruger det samme, inklusive registret og hvert sidehoved.

2. Sæt version, dato og godkender på hver side

   Et versionsnummer, der kun findes i et filnavn eller i dokumentets egenskaber, er usynligt, i det øjeblik nogen printer siden eller videresender et skærmbillede. Sæt versionen, ikrafttrædelsesdatoen og godkenderens navn i selve dokumentets sidehoved eller sidefod.

3. Definér hvad der udløser en hovedversion, før I har brug for det

   Skriv udløseren for hele-tal-trinnet ned (formel godkendelse alene, eller godkendelse plus en væsentlig omskrivning af indholdet), før det første dokument når frem til det. Et team, der aldrig bliver enige om det, ender med to forskellige dokumenter, der begge hedder version 2.

4. Skriv nummereringstrinnene ind i et diagram, i rækkefølge

   Åbn et diagram, og læg hvert trin (udkast, review, revision, godkendelse, publicering, erstatning) i kolonnen Bokstekst, og forbind dem via kolonnen Linje til. Layoutet genereres selv, så den eneste reelle beslutning er den rækkefølge, versionsnummeret bevæger sig igennem.

5. Navngiv den ene autoritative placering

   Vælg det ene sted, den gældende version lever (en styret mappe, et dokumenthåndteringssystem eller et live QueryChart-link), og lad hver anden henvisning pege på det i stedet for at rumme en kopi. Et versionsnummer betyder intet, hvis to »gældende« kopier kan være uenige.

6. Læs ændringsloggen i stedet for at spørge, hvem der har den seneste kopi

   Åbn diagrammets versionshistorik, og brug Sammenlign versioner til at se præcis hvilket felt der ændrede sig mellem to revisioner, hvem der ændrede det, og hvornår, frem for at føre en parallel changelog i hånden. Se /features/version-control for, hvordan ændringsloggen og gendannelse fungerer.

Ofte stillede spørgsmål

Hvad er dokumentversionsstyring?

Dokumentversionsstyring er praksissen med at tildele et entydigt nummer til hvert udkast og hver udstedt kopi af et dokument, så alle, der sidder med en kopi, kan afgøre, hvor gældende den er, og hvordan den forholder sig til hver anden kopi, der har eksisteret. Det parrer typisk et decimalsystem til udkast, der stadig er i review, med hele tal til versioner, der er formelt godkendt, og det afhænger af, at hver side bærer det nummer, frem for at lade det ligge i et filnavn eller et separat register.

Hvordan versionsstyrer jeg et dokument, trin for trin?

Fastlæg et nummereringssystem, før I skriver noget som helst udkast: decimaler til udkast, hele tal til udstedte kopier er den almindelige konvention. Sæt version, dato og godkender i sidehovedet på hver side. Send hvert udkast gennem samme review- og godkendelsescyklus, og optæl den mindre version ved hver omarbejdningsrunde og hovedversionen kun ved formel underskrift. Hold præcis én autoritativ, gældende placering, og markér, slet aldrig, den version, en ny erstatter.

Hvad er forskellen på versionsstyring og revisionsstyring for et dokument?

I praksis beskriver de to udtryk det samme for et dokument (et system til at nummerere de efterfølgende kopier), og de fleste kvalitetssystemer bruger dem i flæng. Hvor der viser sig en reel forskel, er i software- og ingeniørsammenhænge, hvor »revisionsstyring« nogle gange antyder en fuld historik over ændringssæt, mens »versionsstyring« bruges løsere om selve nummereringsetiketten. Vælg ét udtryk, og brug det konsekvent, frem for at behandle en forskel, der ikke findes, som betydningsfuld; se /da/guides/revisionsstyring-kontra-versionsstyring for den fyldigere sammenligning.

Har jeg brug for en separat changelog, hvis jeg allerede har versionsnumre?

Ikke hvis jeres versionsnumre bakkes op af noget, der allerede registrerer, hvem der ændrede hvilket felt, og hvornår. QueryCharts ændringslog gør det automatisk for hver redigering, og Sammenlign versioner sætter to revisioner side om side og markerer forskellen, så en håndført changelog dobbeltarbejder noget, platformen allerede gør. Se /features/version-control.