Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

RFC 80: Rename master branch to main in all repositories #80

Draft
wants to merge 3 commits into
base: master
Choose a base branch
from
Draft
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 28 additions & 0 deletions rfcs/main_branch.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
# RFC #80: Rename `master` branch to `main` in all repositories

## Summary

Rename `master` branch to `main` in all repositories in the [web-platform-tests org](https://github.com/web-platform-tests).

## Details

These are our existing repos, excluding archived and private ones:
- https://github.com/web-platform-tests/data-migration
- https://github.com/web-platform-tests/editor
- https://github.com/web-platform-tests/rfcs
- https://github.com/web-platform-tests/wpt
- https://github.com/web-platform-tests/wpt-empty
- https://github.com/web-platform-tests/wpt-metadata
- https://github.com/web-platform-tests/wpt-pr-bot
- https://github.com/web-platform-tests/wpt.fyi
- https://github.com/web-platform-tests/wpt.live

TODO: which external repos hardcode the name of the default branch in any WPT repo?
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Probably many bots that interact with wpt e.g. the gecko sync bot definitely has some hardcoded branch names.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I wasn't planning to flesh this out today, but I think what I'd propose here to make the transition work is to have both main and master branch updated and kept in sync for a while, so that the migration in other repos can happen at a leisurely pace and not strongly coordinated with the default branch change.

The alternative of having other repos be able to handle both branch names and later clean it up seems riskier and very un-fun.


TODO: which repos need to maintain a `master` branch during a transition period?

TODO: impact on open PRs?

## Risk

Calamity