Natuurlijk! Hier is een uitgebreide gids om je Git commit workflow te analyseren en te verbeteren met geavanceerde Commitizen-praktijken voor jouw webapplicatie en team van vier personen: 1. Consistente en Betekenisvolle Commit-berichten Schrijven ------------------------------------------------------------- Gebruik een gestructureerde commit-berichtstijl zoals de **Conventional Commits** specificatie, die door Commitizen wordt ondersteund. Dit zorgt voor duidelijke, consistente en machine-leesbare berichten. **Stappen:** - **Gebruik een gestandaardiseerd formaat:** ```plaintext <type>(<scope>): <subject> ``` Bijvoorbeeld: ```plaintext feat(login): voeg OAuth login toe fix: herstel fout in formulierverwerking docs(readme): update installatie-instructies chore: update dependencies ``` - **Types en scopes:** - `feat`: nieuwe functionaliteit - `fix`: bugfixes - `docs`: documentatie - `style`: code stijl, witruimte - `refactor`: code verandering zonder functionaliteitswijziging - `test`: test toevoegingen of aanpassingen - `chore`: onderhoud, dependencies - Scopes kunnen bijvoorbeeld worden gebruikt voor componenten of modules zoals `(auth)`, `(UI)`, `(API)`. - **Schrijf duidelijke onderwerpen:** Kort en krachtig, max. 50 tekens, begin met een werkwoord in de gebiedende wijs. 2. Integratie van Commitizen Tools ------------------------------------ Gebruik Commitizen om het proces van het schrijven van commit-berichten te standaardiseren en te automatiseren. **Aanbevolen stappen:** - **Installatie:** ```bash npm install -D commitizen ``` - **Initieer Commitizen configuratie:** ```bash npx commitizen init cz-conventional-changelog --save-dev --save-exact ``` - **Gebruik:** In plaats van `git commit`, voer je uit: ```bash npx git-cz ``` Dit opent een interactieve prompt waarin je de type, scope, en bericht kunt invullen volgens de gedefinieerde conventie. - **Automatisering:** Voeg een script toe aan je `package.json` voor eenvoud: ```json "scripts": { "commit": "git-cz" } ``` Nu kunnen teamleden committen met: ```bash npm run commit ``` 3. Verbeterde Changelog en Release Management --------------------------------------------- Gebruik tools zoals **standard-version** of **semantic-release** die na elke commit automatisch changelogs genereren en releases beheren. **Stappen:** - **Installatie van standard-version:** ```bash npm install --save-dev standard-version ``` - **Configuratie:** Voeg toe aan `package.json`: ```json "scripts": { "release": "standard-version" } ``` - **Gebruik:** Na je commits (bijvoorbeeld na een feature of bugfix): ```bash npm run release ``` Dit genereert een changelog op basis van je commit-berichten en maakt een nieuwe versie aan. - **Automatisering met CI/CD:** Integreer dit proces in je CI/CD pipeline voor automatische releases. 4. Hoe deze aanpak te gebruiken voor betere samenwerking en beheer ------------------------------------------------------------- - **Teamafspraken:** Stel duidelijke richtlijnen op voor commit-berichten en gebruik de gestandaardiseerde structuur. - **Code Review:** Door consistente berichten wordt code review efficiënter en begrijpelijker. - **Changelog en Releases:** Automatische changelogs zorgen voor transparantie en eenvoudige versiebeheer. - **Documentatie:** Documenteer jouw commit-praktijken en zorg dat alle teamleden ze gebruiken. **Kort samengevat:** - Implementeer Commitizen voor gestandaardiseerde commits. - Gebruik een conventie zoals Conventional Commits. - Automatiseer changelogs en releases met standaard-version of semantic-release. - Bevorder teamafspraken en documenteer de workflow. Met deze geavanceerde commit-praktijken verbeter je niet alleen de consistentie en kwaliteit van je project, maar maak je ook het releaseproces overzichtelijk en efficiënt voor je team.

Zeker! Ik help je graag met het analyseren en verbeteren van jullie Git commit workflow met behulp van geavanceerde Commitizen praktijken. Hier is een complete handleiding specifiek voor jullie webapplicatie project met 4 teamleden. ## 1. Consistente Commit Berichten Schrijven ### Conventional Commits Specificatie Implementeer de Conventional Commits standaard voor betekenisvolle commit berichten: ``` <type>(<scope>): <korte beschrijving> [optioneel lichaam] [optioneel footer] ``` **Type voorbeelden voor webapplicatie:** - `feat`: Nieuwe functionaliteit - `fix`: Bug oplossing - `docs`: Documentatie wijzigingen - `style`: Opmaak (geen code verandering) - `refactor`: Code refactoring - `test`: Test toevoegingen/wijzigingen - `chore`: Onderhoudstaken **Voorbeelden:** ``` feat(auth): implementeer Google OAuth login fix(ui): repareer responsive layout op mobile refactor(api): optimaliseer database queries ``` ## 2. Geautomatiseerde Commitizen Tools Integreren ### Stap 1: Commitizen Installatie ```bash npm install --save-dev commitizen cz-conventional-changelog ``` ### Stap 2: package.json Configuratie ```json { "config": { "commitizen": { "path": "./node_modules/cz-conventional-changelog" } }, "scripts": { "commit": "git-cz" } } ``` ### Stap 3: Husky voor Pre-commit Hooks ```bash npm install --save-dev husky @commitlint/cli @commitlint/config-conventional ``` ### Stap 4: commitlint.config.js ```javascript module.exports = { extends: ['@commitlint/config-conventional'], rules: { 'type-enum': [ 2, 'always', ['feat', 'fix', 'docs', 'style', 'refactor', 'test', 'chore'] ] } }; ``` ## 3. Team Workflow voor 4 Personen ### Git Hook Setup ```bash # .husky/commit-msg npx --no -- commitlint --edit $1 # .husky/pre-commit npm run lint && npm test ``` ### Gezamenlijke Afspraken: 1. **Branch naming**: `feat/feature-name`, `fix/bug-description` 2. **Commit frequentie**: Kleine, frequente commits 3. **Code reviews**: Elke commit moet gereviewed worden 4. **Squash merges**: Gebruik squash merges voor feature branches ## 4. Changelog en Release Management ### Automatische Changelog Generatie ```bash npm install --save-dev conventional-changelog-cli ``` ### package.json Scripts Toevoegen: ```json { "scripts": { "changelog": "conventional-changelog -p angular -i CHANGELOG.md -s", "release": "npm run changelog && git add CHANGELOG.md && git commit -m 'chore: update changelog'" } } ``` ### Semantic Versioning Automatiseren ```bash npm install --save-dev semantic-release @semantic-release/git ``` ### .releaserc.json Configuratie: ```json { "branches": ["main"], "plugins": [ "@semantic-release/commit-analyzer", "@semantic-release/release-notes-generator", "@semantic-release/npm", "@semantic-release/github", "@semantic-release/git" ] } ``` ## 5. Praktische Implementatie Stappen ### Week 1: Opzet en Training 1. Tools installeren en configureren 2. Team training over conventional commits 3. Eerste test commits maken ### Week 2: Geleidelijke Implementatie 1. Husky hooks activeren 2. Code reviews focussen op commit messages 3. Eerste automatische changelog genereren ### Week 3: Volledige Implementatie 1. Semantic release configureren 2. Automatische versioning implementeren 3. Workflow optimaliseren ## 6. Voordelen voor Jullie Team - **Betere samenwerking**: Duidelijke commit geschiedenis - **Efficiente reviews**: Gestructureerde code changes - **Automatisering**: Minder handmatig werk - **Betere documentatie**: Automatische changelogs - **Professionele releases**: Semantic versioning ## 7. Troubleshooting Tips - Gebruik `npm run commit` in plaats van `git commit` - Zorg dat alle teamleden dezelfde Node.js versie hebben - Documenteer de workflow in jullie README.md - Review regelmatig de commit geschiedenis voor consistentie Start met een kleine pilot voor één feature branch en breid geleidelijk uit. Succes met de implementatie! 🚀