You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CONTRIBUTING.md
+11-35Lines changed: 11 additions & 35 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -69,8 +69,11 @@ Ready to contribute? Here's how to set up `bbox_visualizer` for local developmen
69
69
70
70
5. Create a branch for local development:
71
71
```bash
72
-
git checkout -b name-of-your-bugfix-or-feature
72
+
git checkout -b task/what-you-are-doing
73
73
```
74
+
`task` can be any of the following: feature, bugfix, hotfix, release, chore, refactor, test, docs, ci, build, experiment, and perf.
75
+
76
+
`feature` is for new features, `bugfix` for fixing bugs, `hotfix` for urgent production fixes, `release` for prepping releases, `chore` for maintenance tasks, `refactor` for code restructuring, `test` for test changes, `docs` for documentation updates, `ci` and `build` for pipeline or build config, `experiment` for prototypes, and `perf` for performance improvements.
74
77
75
78
6. Make your changes. Don't forget to add tests!
76
79
@@ -93,10 +96,11 @@ Ready to contribute? Here's how to set up `bbox_visualizer` for local developmen
93
96
```bash
94
97
git add .
95
98
git commit -m "Your detailed description of your changes."
96
-
git push origin name-of-your-bugfix-or-feature
99
+
git push origin task/what-you-are-doing
97
100
```
98
101
99
102
9. Submit a pull request through the GitHub website.
103
+
- When merging to dev, always use "Rebase and merge" option
100
104
101
105
## Git Workflow
102
106
@@ -114,44 +118,16 @@ Ready to contribute? Here's how to set up `bbox_visualizer` for local developmen
114
118
3. Create a Pull Request from your feature branch to dev
115
119
116
120
4. After your feature PR is merged to dev, create a PR from dev to master:
117
-
- Always use "Rebase and merge" option when merging to master
118
-
- This keeps the history clean and linear
119
-
120
-
### Syncing Branches
121
+
- Always use "Create a merge commit" option when merging to master
122
+
- This would mean master will be 1 commit ahead of dev
121
123
122
-
If GitHub shows that branches are out of sync or you can't use "Rebase and merge":
123
-
124
-
1. Create a PR from master to dev on GitHub:
125
-
- Base branch: `dev`
126
-
- Compare branch: `master`
127
-
- Title: "Sync dev with master"
128
-
129
-
2. If there are conflicts, resolve them locally:
124
+
5. To reconcile dev and master, do the following.
130
125
```bash
131
-
# Switch to dev branch
132
126
git checkout dev
133
-
134
-
# Get latest changes
135
-
git fetch origin
136
-
137
-
# Try to merge master (this will show conflicts)
138
-
git merge origin/master
139
-
140
-
# Resolve conflicts in your editor
141
-
# Then commit the resolved changes
142
-
git add .
143
-
git commit -m "Resolve conflicts from master sync"
127
+
git pull origin master
144
128
git push origin dev
145
129
```
146
-
147
-
3. Merge the PR on GitHub once conflicts are resolved
0 commit comments