Het opzetten van een effectieve Git-workflow die naadloos integreert met jouw issue-tracking systeem, zoals Jira of GitHub Issues, voor een webapplicatie, vereist een gestructureerde aanpak. Hieronder vind je stapsgewijze begeleiding en beste praktijken: 1. Kiezen van een werkmethode: - Git Flow of feature-branching: Gebruik aparte branches voor features, bugs en releases. - Integratie met issue-tracking: Koppel branches en commits aan specifieke issues voor betere traceerbaarheid. 2. Koppelen van branches en commits aan issues: - Naamgeving van branches: Verbind branches met issues door de issue-ID in de branch-naam te verwerken, bijvoorbeeld: - `feature/JIRA-123-verbetering-login` - `bugfix/GH-456-fout-wachtwoord` - Commit-berichten: Verwijs altijd naar het issue-ID in het commit-bericht, bijvoorbeeld: - `JIRA-123: Voeg validatie toe aan loginformulier` - `GH-456: Corrigeer fout bij wachtwoordreset` 3. Beste praktijken voor commit-berichten: - Gebruik een consistente structuur: [Issue-ID]: korte beschrijving - Bijvoorbeeld: `JIRA-789: Optimaliseer laadtijd homepage` - Voeg eventueel een uitgebreide beschrijving toe na de kopregel voor meer context. 4. Automatisering van issue-status updates: - Voor GitHub Issues: - Gebruik GitHub Actions of third-party tools zoals ZenHub, GitHub Projects, of scripts die op basis van Git-activiteiten issues automatisch sluiten of bijwerken. - Bijvoorbeeld: een commit met "Closes GH-456" zal automatisch het issue sluiten. - Voor Jira: - Implementeer webhooks of gebruik CI/CD-tools (bijvoorbeeld Jenkins, GitHub Actions) met Jira API-integraties. - Automatische transitions kunnen worden ingesteld zodat bij het mergen van een feature branch gekoppeld aan een Jira-issue, de status wordt aangepast (bijvoorbeeld van 'In Progress' naar 'Done'). 5. Workflow voorbeeld: - Start: Maak een issue aan in Jira of GitHub Issues. - Werk: Maak een branch met de issue-ID in de naam. - Commit: Verwijs in je commit-berichten naar het issue-ID. - Mergen: Bij het mergen van de branch in de hoofdbranch, gebruik woorden als 'Closes', 'Fixes', of 'Resolves' gevolgd door het issue-ID om automatisch issues te sluiten of te updaten. - Resultaat: Issue wordt automatisch bijgewerkt, status verandert naar 'Afgehandeld' of 'Closed'. 6. Extra tips: - Documenteer je workflow en instructies voor teamleden. - Gebruik labels of tags in je issue-tracker voor extra categorisatie. - Test de automatiseringen regelmatig om te zorgen dat issues correct worden bijgewerkt. Door deze aanpak te volgen, creëer je een transparante en efficiënte integratie tussen je Git-repository en issue-tracking, wat de samenwerking en voortgang van je webapplicatie-project verbetert.

Zeker! Hier een uitgebreide uitleg voor het opzetten van een effectieve Git-workflow geïntegreerd met je issue-tracking systeem voor een webapplicatie. ## 1. Branching Strategie ### Git Flow of GitHub Flow Voor webapplicaties raad ik **GitHub Flow** aan vanwege zijn eenvoud: - `main` branch - altijd productieklaar - Feature branches voor elke nieuwe functionaliteit - Hotfix branches voor urgente fixes ### Branch naamconventie ```bash # Koppel branches direct aan issues feature/ISSUE-123-authenticatie-systeem bugfix/ISSUE-456-login-probleem hotfix/ISSUE-789-beveiligingslek ``` ## 2. Issue Tracking Integratie ### GitHub Issues (Automatische integratie) - Branches automatisch koppelen via branch naam - Commits automatisch linken bij vermelding van `#issuenummer` - Pull requests automatisch koppelen ### Jira Integratie - Installeer Jira Git-integratie - Configureer de koppeling tussen je Git repository en Jira project - Gebruik Jira issue keys in branches en commits ## 3. Commit Bericht Conventies ### Standaard formaat ``` ISSUE-123: Korte beschrijving van de wijziging Uitgebreide beschrijving van de changes: - Wijziging 1 - Wijziging 2 - Wijziging 3 [optional footer met aanvullende info] ``` ### Goede voorbeelden ```bash # GitHub Issues git commit -m "Fix user authentication #45 - Repareer JWT token validatie - Voeg error handling toe" # Jira git commit -m "ISSUE-123: Implement user dashboard - Toon gebruikersstatistieken - Voeg responsive design toe" ``` ## 4. Automatische Status Updates ### GitHub Actions Workflow ```yaml name: Update Issue Status on: pull_request: types: [closed] jobs: update-issue: runs-on: ubuntu-latest steps: - name: Move issue to Done if: github.event.pull_request.merged == true run: | # Script om issue status bij te werken echo "Issue #${{ github.event.pull_request.number }} gemarkeerd als voltooid" ``` ### Jira Automatisering - Gebruik Jira Automation rules - Stel triggers in op basis van: - Branch creation → "In Progress" - Pull Request → "Review" - Merge → "Done" ## 5. Praktische Stappen ### Stap 1: Repository Setup ```bash # Branch maken gekoppeld aan issue git checkout -b feature/ISSUE-123-nieuwe-functionaliteit # Werken en committen git add . git commit -m "ISSUE-123: Implement basis functionaliteit" git push origin feature/ISSUE-123-nieuwe-functionaliteit ``` ### Stap 2: Pull Request Proces - PR titel: `ISSUE-123: Beschrijving van de wijziging` - PR beschrijving: `Fixes #123` of `Closes ISSUE-123` - Reviewers toevoegen - CI/CD checks afwachten ## 6. Best Practices ### Commit Guidelines - Één commit per logische wijziging - Duidelijke, beschrijvende commit messages - Altijd issue nummer vermelden - Commit messages in tegenwoordige tijd ### Branch Management - Korte-lived branches (max 2-3 dagen) - Regelmatig mergen van main naar feature branches - Branches verwijderen na merge ### Tooling Tips - Gebruik Git hooks voor consistentie - Configureer IDE plugins voor Jira/GitHub - Stel team-afspraken vast over conventies ## 7. Geavanceerde Automatisering ### Pre-commit Hooks ```bash #!/bin/bash # Controleer of commit message issue referentie bevat if ! grep -q -E "(#[0-9]+|ISSUE-[0-9]+)" "$1"; then echo "Waarschuwing: Commit message bevat geen issue referentie" echo "Gebruik formaat: ISSUE-123: beschrijving" fi ``` ### CI/CD Integratie - Automatische tests bij elke push - Deployment naar testomgeving bij merge - Status updates naar issue tracking systeem Deze workflow zorgt voor: - **Traceerbaarheid**: Elke wijziging terug te leiden naar een issue - **Transparantie**: Duidelijk overzicht van voortgang - **Automatisering**: Minder handmatig werk - **Kwaliteit**: Gestandaardiseerde processen Pas deze richtlijnen aan op je specifieke projectbehoeften en teamgrootte!