| title | impact | impactDescription | tags |
|---|---|---|---|
PR Creation Best Practices |
HIGH |
PRs that don't follow guidelines slow down review cycles |
pull-request, code-review, workflow |
Create pull requests in draft mode by default, so that a human reviewer can mark it as ready for review only when it is.
- Use conventional commits:
feat:,fix:,refactor: - Be specific:
fix: handle timezone edge case in booking creation - Not generic:
fix: booking bug
- Large PRs (>500 lines or >10 files) are not recommended
- Split large changes by layer (database, backend, frontend)
- Split by feature component (API, UI, integration)
- PR title must follow Conventional Commits specification
- For most PRs, you only need to run linting and type checking
- E2E tests will only run if PR has "ready-for-e2e" label
- Run
yarn type-check:ci --forceto check types - Run
yarn biome check --write .to lint and format - Run relevant tests locally