28 lines
1.4 KiB
Markdown
28 lines
1.4 KiB
Markdown
## Branching & Conflict Resolution Strategy (GitHub Flow)
|
|
|
|
This project strictly follows the **GitHub Flow**. All development happens in short-lived feature branches branched off from `main`. Direct commits to `main` are prohibited.
|
|
|
|
### 1. Development Workflow
|
|
1. **Branch Creation:** Create a descriptive branch from the latest `main` state:
|
|
`git checkout main && git pull && git checkout -b feature/your-feature-name`
|
|
2. **Atomic Commits:** Make small, logical, and self-contained commits.
|
|
3. **Push & Pull Request:** Push the branch and open a Pull Request (PR) against `main` for review.
|
|
|
|
### 2. Merge Conflict Policy
|
|
When multiple features are developed simultaneously, `main` might advance before your PR is merged, causing a merge conflict. **The author of the pending PR is solely responsible for resolving conflicts.**
|
|
|
|
#### Resolution Procedure:
|
|
Never force-push blindly or overwrite other developers' work without understanding it. Follow these exact steps to resolve a conflict:
|
|
|
|
1. **Fetch Latest Main:** Update your local repository's main branch:
|
|
```bash
|
|
git checkout main
|
|
git pull origin main
|
|
|
|
### 3. Documentation Update
|
|
|
|
.md Files die nichts an der Integrität oder Impact der Codebase beiwirken sollen als einfacher Commit in Main behandelt werden.
|
|
|
|
## Project Management
|
|
|
|
- The Current Development Progress is tracked and marked down and always updated in the File `TODO.md` |