docs: establish project documentation baseline
This commit is contained in:
30
docs/decisions/004-feature-branch-workflow.md
Normal file
30
docs/decisions/004-feature-branch-workflow.md
Normal file
@ -0,0 +1,30 @@
|
||||
# 004 – Kortlivade feature-branches
|
||||
|
||||
## Status
|
||||
|
||||
Accepterat
|
||||
|
||||
## Sammanhang
|
||||
|
||||
HemHub utvecklas inkrementellt med avgränsade ändringar. Historiska
|
||||
feature-branches ska kunna raderas efter merge utan att projektets motiv och
|
||||
aktuella läge försvinner.
|
||||
|
||||
## Beslut
|
||||
|
||||
Varje feature eller avgränsad ändring utvecklas på en kortlivad branch som
|
||||
skapas från uppdaterad `main`. Kod, tester och relevant dokumentation ingår i
|
||||
samma ändring.
|
||||
|
||||
Commit och push görs först efter uttrycklig instruktion. Merge sker efter
|
||||
verifiering, och `main` ska representera verifierad kod. Därefter kan branchen
|
||||
raderas.
|
||||
|
||||
## Konsekvenser
|
||||
|
||||
- Pågående arbete isoleras från `main`.
|
||||
- En feature kan granskas och verifieras som en sammanhållen ändring.
|
||||
- Dokumentationen måste uppdateras före merge så att raderade branches inte
|
||||
behövs för att förstå projektet.
|
||||
- Övergripande beslut bevaras i `docs/decisions/` och faktisk featurehistorik i
|
||||
`docs/features/`.
|
||||
Reference in New Issue
Block a user