Versionshantering

Allt underlag i kravportalen versionshanteras. Genom att använda GitLab kan allt material som hanteras och distribueras spåras noggrant. Versionshantering i GitLab gör det möjligt att dokumentera och följa alla ändringar på detaljnivå. Detta innebär att du alltid kan se vem som har gjort vilka ändringar och när de har gjorts.

Versionshanteringen i GitLab använder ett system för semantisk versionshantering, vilket innebär att versionsnumren följer formatet MAJOR.MINOR.PATCH. Detta system hjälper till att förstå omfattningen och betydelsen av ändringar mellan olika versioner:

Release candidate (rc) är en preliminär version som är under färdigställande och potentiellt kan bli den slutliga versionen.

GitLab används för att skapa och hantera olika paket som till exempel Informationskrav, Värdelistor, Metoder och Mallfiler. Vid publicering till Infopack, ett ramverk utvecklat av BIM Alliance, tilldelas varje paket ett unikt versionsnummer. Infopack fungerar som ett centralt nav för förvaltning och distribution av information.

Vid revidering av innehåll i GitLab sker en noggrann granskning och uppdatering av de aktuella paketen. Efter verifiering och godkännande stämplas de reviderade paketen med ett nytt versionsnummer och publiceras till Infopack. Detta säkerställer att alla ändringar är spårbara och att den senaste informationen alltid är tillgänglig.

Genom att använda GitLab tillsammans med Infopack-ramverket säkerställs en effektiv hantering, förvaltning och distribution av information.

Infopack förvaltar all information med versionsnummer och paketerar den för distribution till exempelvis WordPress (Kravportalen).

I figur 1 presenteras fyra olika paket i infopack för VA SYD och fler kommer.

Figur 1 : Paket i infopack

När du väljer ett paket, till exempel “Informationsleveranskrav”, får du tillgång till allt som har publicerats under den valda versionen. Varje paket innehåller detaljerad information om versionerna, vilket gör det enkelt att spåra och förstå uppdateringar över tid.

Figur 2 : Versioner för paketet metod

För att hitta de aktuella Infopacksen se sidfoten på denna hemsida.

Figur: sidfoten

Där finns även information om hur Infopack är uppbyggt och fungerar
Vid klick på den nuvarande versionen, till exempel  “1.0.0” omdirigeras du till versionssidan.

Med hjälp av funktionen “Changes” i GitLab kan du enkelt identifiera och granska förändringar. Denna funktion visar en sammanställning av alla ändringar, inklusive tillägg, borttagningar och modifieringar i filer. Funktionerna inkluderar:

• Översikt: Få en snabb översikt över alla förändringar. Text markerad i rött indikerar borttagningar, medan text markerad i grönt visar tillägg.
• Detaljerad granskning: Se exakt vilka rader i filerna som har ändrats, vilket underlättar noggrann granskning.
• Kommentarer: Lägg till kommentarer direkt på specifika ändrade rader för att underlätta diskussion och feedback mellan teammedlemmar.
• Spårbarhet: Se historik över tidigare ändringar, vilket gör det enkelt att förstå varför och hur en viss förändring gjordes.

Vad är ett repository?

Ett repository är ett digitalt arkiv där källkod, dokumentation, konfigurationsfiler och andra relaterade data för ett projekt lagras. Här är några nyckelfunktioner:

1. Versionskontroll: Ett repository spårar ändringar i filerna över tid. Varje ändring, eller “commit”, dokumenteras med information om vad som ändrades och vem som gjorde ändringen. Detta gör det möjligt att gå tillbaka till tidigare versioner av filer eller hela projektet.
2. Historik: Repositoryt innehåller en fullständig historik av alla ändringar som gjorts, vilket gör det enkelt att förstå utvecklingen av projektet, spåra fel, och se hur projektet har utvecklats över tid.
3. Brancher: Ett repository kan innehålla flera “brancher” (grenar), som tillåter utvecklare att arbeta på olika funktioner eller experimentella ändringar utan att påverka huvudversionen av projektet. Brancher kan senare slås samman (merge) med huvudgrenen (vanligtvis “main” eller “master”).
4. Samarbete: Ett repository gör det enkelt för flera personer att samarbeta på samma projekt. Ändringar kan delas och integreras genom att använda pull requests (i GitLab kallade Merge Requests) eller genom att göra “push” och “pull” operationer.

Remote och Local: Ett repository kan vara antingen lokalt (på din egen dator) eller remote (på en server som GitHub, GitLab, eller Bitbucket). En remote repository används för att lagra och dela projekt med andra, medan en lokal repository används för att utveckla och testa koden på din egen maskin.

Vad är forking?

Forking är en process där du skapar en kopia av ett befintligt repository. Denna kopia är helt separat från originalet och kan ändras oberoende av det ursprungliga projektet.

Arbetsprocess och nytta:

• Arbetsprocess: När du har forkatt ett repository, kan du göra ändringar fritt i din egen kopia. Detta är användbart för att bidra till ett projekt utan att direkt påverka det ursprungliga repositoryt. Du kan arbeta på nya funktioner, buggrättelser, eller experimentera utan risk för att påverka det primära projektet.
• Nytta: Forking är särskilt användbart i där du vill göra ändringar eller förbättringar och senare skicka dina ändringar tillbaka till huvudprojektet genom en Merge Request. Det ger också möjlighet att arbeta med projekt som du inte har direkt skrivbehörighet till, samtidigt som du behåller en tydlig separation mellan dina ändringar och originalet.

Vad är cloning?

Cloning är processen där du skapar en lokal kopia av ett repository. Denna kopia är en exakt avbild av repositoryt på GitLab och innehåller hela historiken och alla filer.

Arbetsprocess och nytta:

• Arbetsprocess: Att klona ett repository gör att du kan arbeta på projektet offline och göra ändringar lokalt. När du är klar med dina ändringar kan du synkronisera dina ändringar tillbaka till GitLab
• Nytta: Cloning är användbart för att få en fullständig lokal arbetsmiljö för ett projekt. Det gör det också lätt att samarbeta med andra, eftersom du kan göra ändringar, testa dem och sedan enkelt synkronisera dina uppdateringar med det centrala repositoryt.