Terminal: Branch rename: master -> main

Created on 1 Jul 2020  Β·  6Comments  Β·  Source: microsoft/terminal

Description of the new feature/enhancement

I know that there could be a decent amount of effort involved in this for a repos with such a large footprint, but I think there's no time like the present to "commit" ourselves (oh god the pun! the πŸ”₯) to (seriously) Doing Better as people, developers, and as global citizens.

I propose renaming the current master branch to main as an acknowledgement of the community's commitment to recognizing the existence of racial injustice. However small or trivial an act it may seem to some, I feel that it's a worthwhile undertaking.

As a phrase I'm oft known to cite goes, "excellence is a game of inches".

The IETF presents a detailed discussion of the reasons why this it is important to note the terminology of branch names, and should be considered a highly useful resource for basing any discussions around context, pertinence, or applicability.

Proposed technical implementation details (optional)

Just spitballing OTOMH the things that might be considered as part of executing on this. Obviously, whomever does this would need to have appropriate repos perms :)

  1. Coordinate with any dependent repos' owners on logistics/timing(if needed) ❓
  2. Disable CI/CD pipelines and PR bots
  3. Create main branch via operation with master checked out via git branch -m master main (note the -m to keep history intact)
  4. Push to main origin
  5. change default branch in GH from master to main
  6. Configure main branch protection, security, etc rules in GH
    5a. Archive/lock or otherwise deprecate master branch
  7. Re-Enable CI/CD, test/adjust build scripts (if/as needed)
  8. Notify downstream repos ❓
Area-Build Issue-Task Product-Meta Resolution-Fix-Available

Most helpful comment

I'm in support of this, and will assign myself. If there's the possibility that MSFT will roll out a self-service tool that'll properly update refs, PRs, and internal forks I'd prefer to wait for that.

All 6 comments

https://github.com/PowerShell/PowerShell/issues/12951#issuecomment-643525573 suggests that GitHub might do something to make renaming less disruptive. It may be better to wait for that.

I'm in support of this, and will assign myself. If there's the possibility that MSFT will roll out a self-service tool that'll properly update refs, PRs, and internal forks I'd prefer to wait for that.

We now have a self-service tool that'll do this and retarget all open PRs and stuff, so here goes!

image

(I'll press it once #7985 merges.)

πŸ‘ That’s great news! Thanks for staying on top of this - looks like it should be pretty smooth

I'm sad to see MS is giving in to politics. I'm strongly in disagreement to this but MS is a large corporation and can do whatever it wants regardless of what anybody else thinks.

Done!

Was this page helpful?
0 / 5 - 0 ratings

Related issues

wkbrd picture wkbrd  Β·  3Comments

zadjii-msft picture zadjii-msft  Β·  3Comments

warpdesign picture warpdesign  Β·  3Comments

mdtauk picture mdtauk  Β·  3Comments

miniksa picture miniksa  Β·  3Comments