Git rules - PolyCortex/pyMuse GitHub Wiki
Branches and commit messages
For this project, we use Feature branches with Pull Requests for merging into master. (Source: https://www.atlassian.com/git/tutorials/comparing-workflows/feature-branch-workflow)
Branch naming conventions
feature/your-branch-name : any work on a feature of the project
bugfix/your-branch-name : any work on a bug of the project
Commit messages convention
The commit message must describe explicitly what are your changes. Those changes must address only one specific task.
Example
Let's say we want to add an exit button to the interface. We would want to create a new branch from master named like this:
feature/exit-button
When we commit on that new branch we would like to have specific commit messages. For example, if we change the position position of the exit button to the top-right corner we would have this message:
"Moved button to top-right corner"
Issues
Resolve an Issue
- Never work directly on master branch
- Write the issue number into your commit message.