Skip to content

GitLab Next

  • Projects
  • Groups
  • Snippets
  • Help
    • Loading...
  • Help
    • See what's new at GitLab
    • Help
    • Support
    • Submit feedback
    • Contribute to GitLab
  • Sign in / Register
GitLab
GitLab
  • Project overview
    • Project overview
    • Details
    • Activity
    • Releases
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
    • Locked Files
  • Issues 29,492
    • Issues 29,492
    • List
    • Boards
    • Labels
    • Service Desk
    • Milestones
  • Merge Requests 1,135
    • Merge Requests 1,135
  • Requirements
    • Requirements
    • List
  • CI / CD
    • CI / CD
    • Pipelines
    • Jobs
    • Schedules
  • Security & Compliance
    • Security & Compliance
    • Dependency List
    • License Compliance
  • Packages & Registries
    • Packages & Registries
    • Container Registry
  • Analytics
    • Analytics
    • CI / CD
    • Code Review
    • Insights
    • Issues
    • Repository
    • Value Stream
  • Snippets
    • Snippets
  • Members
    • Members
  • Collapse sidebar
  • Activity
  • Graph
  • Create a new issue
  • Jobs
  • Commits
  • Issue Boards
  • GitLab.org
  • GitLabGitLab
  • Issues
  • #222204

Closed
Open
Opened Jun 15, 2020 by James Ramsay@jramsay0 of 6 tasks completed0/6 tasks
  • Report abuse
  • New issue
Report abuse New issue

Rename master branch to main branch in the GitLab project

Problem to solve

The default branch of this repository is current master. We should move to a different default branch name for **this repository for two reasons:

  1. master is not easily understood by people new to Git, and is not a ubiquitous term in technology (master is more easily associated with primary/secondary configurations)
  2. master may reference the master/slave terminology used by BitKeeper. Use of master/slave terminology has been removed in recent versions of many major software projects because it is not technically descriptive, precise, and avoids needlessly referencing the awful history and impact of human/slavery which continues to be felt by people all over the world.

This issue is about this project only. Related issues:

  • instance configuration
  • changing default for new projects and new instances

Further details

Proposal

Rename the master branch to main

Process:

  • create main branch from master
  • make main the default branch
  • update release processes to use main branch
  • update Developer documentation, and GDK documentation
  • ... probably many other steps
  • remove master branch
Edited Jun 16, 2020 by James Ramsay

Linked issues

  • Discussion
  • Designs
Assignee
Assign to
None
Milestone
None
Assign milestone
Time tracking
None
Due date
None
1
Labels
auto updated
Assign labels
  • View project labels
Reference: gitlab-org/gitlab#222204