Conventional Branch 1.0.0
Summary
Conventional Branch refers to a structured and standardized naming convention for Git branches which aims to make branch more readable and actionable. We’ve suggested some branch prefixes you might want to use but you can also specify your own naming convention. A consistent naming convention makes it easier to identify branches by type.
Key Points
- Purpose-driven Branch Names: Each branch name clearly indicates its purpose, making it easy for all developers to understand what the branch is for.
- Integration with CI/CD: By using consistent branch names, it can help automated systems (like Continuous Integration/Continuous Deployment pipelines) to trigger specific actions based on the branch type (e.g., auto-deployment from release branches).
- Team Collaboration : It encourages collaboration within teams by making branch purpose explicit, reducing misunderstandings and making it easier for team members to switch between tasks without confusion.
Specification
Branch Naming Prefixes
The branch specification by describing with feature/
, bugfix/
, hotfix/
, release/
and chore/
and it should be structured as follows:
<type>/<description>
- main: The main development branch (e.g.,
main
,master
, ordevelop
) - feature/: For new features (e.g.,
feature/add-login-page
) - bugfix/: For bug fixes (e.g.,
bugfix/fix-header-bug
) - hotfix/: For urgent fixes (e.g.,
hotfix/security-patch
) - release/: For branches preparing a release (e.g.,
release/v1.2.0
) - chore/: For non-code tasks like dependency, docs updates (e.g.,
chore/update-dependencies
)
Basic Rules
- Lowercase and Hyphen-Separated: Always use lowercase letters, and separate words with hyphens. For example,
feature/new-login
orbugfix/header-styling
. - Alphanumeric and Hyphens Only: Use only lowercase letters (a-z), numbers (0-9), and hyphens. Avoid special characters like spaces, punctuation, and underscores.
- No Consecutive Hyphens: Ensure that hyphens are used singly, with no consecutive hyphens (e.g.,
feature/new-login
, notfeature/new--login
). - No Trailing Hyphens: Do not add a hyphen at the end of the branch name. For instance, use
feature/new-login
instead offeature/new-login-
. - Clear and Concise: Make branch names descriptive but concise. The name should clearly indicate the work being done.
- Include Jira (or Other Tool) Ticket Numbers: If applicable, include the ticket number from your project management tool to make tracking easier. For example, for a ticket
T-123
, the branch name could befeature/T-123-new-login
.
Conclusion
- Clear Communication: The branch name alone provides a clear understanding of its purpose the code change.
- Automation-Friendly: Easily hooks into automation processes (e.g., different workflows for
feature
,release
, etc.). - Scalability: Works well in large teams where many developers are working on different tasks simultaneously.
In summary, conventional branch is designed to improve project organization, communication, and automation within Git workflows.
FAQ
What tools can be used to automatically identify if a team member does not meet this specification?
You can used commit-check to check branch specification or commit-check-action if your codes are hosted on GitHub.