commitbeskeder

Commitbeskeder er tekster, der følger ændringer i et versionkontrolsystem som Git. De beskriver hvad der blev ændret, hvorfor ændringen blev foretaget, og hvordan den påvirker kodebasen. Korrekte beskeder gør historikken lettere at gennemgå, fejl at spore og ændringer at forstå i fremtidig udvikling.

Strukturen i en commitbesked varierer, men en ofte anvendt form består af en kort emne-linje og eventuelt en længere tekst. Emnelinjen bør være kort (omkring 50 tegn eller mindre) og formuleres i nutid og i imperativ form, fx "Tilføjer login-funktionalitet" eller "Fik fejl i betalingsflow". Brødteksten kan give detaljer, motivering og eksempler samt referencer til relaterede sager eller bilag. Nogle projekter bruger også en specialiseret footer til yderligere information som B.R.E.A.K.I.N.G. CHANGES eller referencer til issue-numre.

Bedste praksis inkluderer at holde commits små og fokuserede, at skrive klare og meningsfulde emne-linjer, og at undgå generelle eller vage beskeder som bare "opdateringer" eller "fix". Det anbefales at forklare hvorfor ændringen blev lavet og ikke blot hvad der blev gjort, og at anvende en konsekvent stil på tværs af projektet. Nogle teams følger stilen Conventional Commits, der foreslår typer som feat, fix, docs, style, refactor og mere, for at standardisere beskeder og lette tooling.

Anvendelsen af klare commitbeskeder gælder for de fleste moderne VCS og teams. De understøtter procesdiscipliner som code review, automatisering af changelogs og release-notes i CI/CD pipelines, og forbedrer sporbarheden i projektet.