Code repositories should use “main” as the default branch name
Introduction
We use main rather than master as the default branch name for all new code repositories.
Decision
Use "main" as the base branch name for code repositories instead of "master." The team would be able to safely assume that the default branch is main and wouldn’t need to look it up in the repository settings.
Context
Many platforms and organizations are adopting more neutral terms like "main" for their base branch names due to concerns regarding the historical connotations associated with the term "master" in version control systems. This decision reflects our sensitivity to diverse perspectives and aligns with prevailing industry practices.
Consequences
- Requires to have CI to convert branch names from main to master on platforms that require master as branch
- Team Adjustment: Some initial adjustments are required for team members accustomed to using "master."
Exceptions
- Existing projects already set the base branch as "master."
- Project requirements mandate using master as default branch name
Additional Resources
None