Pas SourceTree aan voor verbeterde commitberichtsjablonen
description
Deze prompt helpt gebruikers bij het opzetten van gestandaardiseerde commitberichten in SourceTree, wat communicatie en traceerbaarheid in versiebeheer verbetert. Het lost het probleem op van inconsistente of onduidelijke commitbeschrijvingen en biedt praktische sjablonen en configuratie-instructies die de samenwerking binnen teams en leesbaarheid van projectgeschiedenis verbeteren.
prompt
Help me bij het instellen en aanpassen van commitberichtsjablonen in SourceTree. Mijn projecttype: <voer het type project in>. Welke best practices moet ik volgen voor het formatteren va ...
try_prompt
generate_helper
disclaimerOnPageApi
tags
ai_answers
provider: openai
model: gpt-4.1-nano
Natuurlijk! Hier is een overzicht van hoe je commitberichtsjablonen instelt en aanpast in SourceTree, plus best practices en voorbeelden voor jouw webapplicatieproject.
**1. Commitberichtsjablonen instellen in SourceTree**
SourceTree zelf biedt geen ingebouwde functie voor het rechtstreeks instellen van commitjablonen. Echter, je kunt dit bereiken door:
- Een commitberichtsjabloonbestand te maken (bijvoorbeeld `.gitmessage.txt`)
- Dit bestand te gebruiken telkens je commit maakt, of door een Git-configuratie in te stellen.
**Stappen:**
a. Maak een bestand `.gitmessage.txt` aan in je projectmap of een centrale locatie, bijvoorbeeld:
```plaintext
# Voeg een korte beschrijving toe (max. 50 tekens)
[TYPE]: [Kort overzicht] (#issue #ticket)
# Beschrijving
[Gedetailleerde uitleg van de verandering]
# Type (gebruik bijvoorbeeld):
feat: nieuwe functionaliteit
fix: bugfix
docs: documentatie
style: opmaak, witruimte, etc.
refactor: codeherstructurering
test: tests
chore: andere taken
```
b. Stel Git in om dit sjabloon te gebruiken:
```bash
git config commit.template /pad/naar/.gitmessage.txt
```
Je kunt deze regel toevoegen aan je `.git/config` of globale config (`git config --global ...`).
c. In SourceTree: Wanneer je commit maakt, wordt de inhoud van dit bestand geladen in het commitbericht. Je kunt het sjabloon aanpassen en vervolgens je bericht invullen.
**2. Best practices voor formatteren van commitberichten**
- **Kort en krachtig:** max. 50 tekens voor de titel.
- **Gebruik een duidelijke prefix:** zoals feat, fix, docs, style, refactor, test, chore.
- **Scheiding tussen titel en bericht:** laat een lege regel tussen titel en details.
- **Beschrijf waarom en wat:** niet alleen wat is veranderd, maar ook waarom.
- **Verwijs naar issues/tickets:** bijvoorbeeld #123.
- **Gebruik de imperatief:** "Voeg toe", "Herstructureer", "Fix".
**3. Voorbeeld van een effectief commit-sjabloon**
```plaintext
<type>: <korte samenvatting> (#<ticketnummer>)
<gedetailleerde beschrijving van de verandering, waarom en hoe>
```
Voorbeeld:
```plaintext
feat: voeg gebruikersregistratie toe (#45)
Implementatie van de gebruikersregistratie functionaliteit, inclusief validatie en error handling. Dit verbetert de onboarding ervaring voor nieuwe gebruikers.
```
**4. Aanpassen en consistent houden binnen je team**
- Deel het commit-sjabloonbestand met je team.
- Moedig het gebruik van het sjabloon aan tijdens code reviews.
- Automatiseer waar mogelijk door pre-commit hooks, bijvoorbeeld met Husky, om te controleren of berichten voldoen aan de formatregels.
- Documenteer de commit standards in je teamhandleiding.
---
**Kort samengevat:**
- Maak een commitberichtsjabloon (`.gitmessage.txt`).
- Stel Git in om dit sjabloon te gebruiken (`git config commit.template ...`).
- Gebruik consistente prefixen en structuur.
- Deel de richtlijnen en sjablonen met je team.
Als je verdere hulp nodig hebt bij het opzetten van automatisering of het schrijven van richtlijnen, laat het gerust weten!
provider: deepseek
model: deepseek-chat
Zeker! Hier een uitgebreide handleiding voor het instellen van commitberichtsjablonen in SourceTree voor webapplicatieontwikkeling:
## Best Practices voor Commitberichten
**Conventionele Commits Aanbevolen:**
```
<type>[optioneel scope]: <beschrijving>
[optioneel lichaam]
[optioneel footer(s)]
```
**Type opties voor webdevelopment:**
- `feat`: Nieuwe functionaliteit
- `fix`: Bug reparatie
- `docs`: Documentatie wijzigingen
- `style`: Opmaak (geen code verandering)
- `refactor`: Code refactoring
- `test`: Test toegevoegd/gewijzigd
- `chore`: Onderhoudstaken
## Voorbeeld Sjablonen
### 1. Basis Feature Template
```
feat: [korte beschrijving]
- [ ] Getest in [browser/omgeving]
- [ ] Code review voltooid
- [ ] Documentatie bijgewerkt
JIRA: [ticket-nummer]
```
### 2. Bug Fix Template
```
fix: [probleem beschrijving]
Oorzaak:
[uitgelegd oorzaak]
Oplossing:
[beschrijving oplossing]
Getest in:
- [ ] Chrome
- [ ] Firefox
- [ ] Mobile
JIRA: [ticket-nummer]
```
### 3. Refactor Template
```
refactor: [component/module naam]
Wijzigingen:
- [beschrijving wijziging 1]
- [beschrijving wijziging 2]
Impact:
- [performance/onderhoudbaarheid/etc]
```
## Instellen in SourceTree
### Stap 1: Template Bestand Maken
1. Maak een `.gitmessage.txt` bestand in je project root
2. Plaats je gewenste template erin
3. Sla op in UTF-8 encoding
### Stap 2: Globale Git Configuratie
```bash
git config --global commit.template ~/.gitmessage.txt
```
### Stap 3: SourceTree Instellingen
1. Open SourceTree → Preferences (⌘,)
2. Ga naar "Git" tab
3. Bij "Commit template" selecteer je je template bestand
4. Vink "Use the system default editor for commit messages" aan
### Stap 4: Project-specifieke Template
Voor project-specifieke templates:
```bash
cd /jouw/project/pad
git config commit.template .gitmessage.txt
```
## Team Consistency Tips
### 1. Shared Template Repository
- Bewaar templates in een gedeelde repository
- Gebruik `git submodule` of package manager om templates te delen
### 2. Pre-commit Hooks
Maak een `.git/hooks/prepare-commit-msg` script:
```bash
#!/bin/bash
COMMIT_MSG_FILE=$1
COMMIT_SOURCE=$2
SHA1=$3
# Voeg template toe als leeg bericht
if [ -z "$COMMIT_SOURCE" ]; then
cat .gitmessage.txt > "$COMMIT_MSG_FILE"
fi
```
### 3. Code Review Checklist
Zorg dat je team controleert op:
- [ ] Type prefix aanwezig
- [ ] Korte, duidelijke beschrijving
- [ ] Ticket referentie indien van toepassing
- [ ] Test informatie voor kritieke wijzigingen
## Geavanceerde Template Voorbeelden
### Front-end Development
```
feat(ui): [component naam] implementatie
Component features:
- [feature 1]
- [feature 2]
Browser support:
- [ ] Chrome 90+
- [ ] Firefox 88+
- [ ] Safari 14+
Accessibility:
- [ ] WCAG 2.1 compliant
- [ ] Keyboard navigation
- [ ] Screen reader tested
Design system: [versie]
```
### Back-end API Template
```
feat(api): [endpoint] endpoint toegevoegd
Endpoint: /api/v1/[resource]
Method: [GET/POST/PUT/DELETE]
Request body:
[voorbeeld request]
Response:
[voorbeeld response]
Security:
- [ ] Authentication required
- [ ] Rate limiting applied
- [ ] Input validation
Documentation: [link naar docs]
```
## Troubleshooting
**Probleem**: Template wordt niet geladen
**Oplossing**: Controleer pad in Git config: `git config --list | grep commit.template`
**Probleem**: Speciale characters werken niet
**Oplossing**: Zorg dat template in UTF-8 is opgeslagen
**Probleem**: Team members hebben verschillende templates
**Oplossing**: Gebruik project-specifieke configuratie en commit de `.gitmessage.txt`
Deze aanpak zorgt voor consistente, informatieve commitberichten die je development workflow significant verbeteren!