Git Workflow — DoclingOptimisation
Branching (GitHub Flow)
mainis always deployable- Short-lived feature branches:
feature/,fix/,chore/,docs/ - Branch from main, merge back to main
- Delete branches after merge
Commits (Conventional)
- Format:
type(scope): description - Types: feat, fix, docs, style, refactor, perf, test, build, ci, chore
- Enforced by
commit-message.shhook - Body explains WHY, not what
Pull Requests
- Keep PRs small and focused
- Squash merge to main
- Include What/Why/How/Testing sections in description
Releases
- Semantic versioning in pyproject.toml
- Docker image tags follow semver
- Git tags trigger CI/CD deployment