Replacing master as the default branch

[romanlutz]

Context: the word master is triggering or at least making people uncomfortable. Haven’t seen a good reason not to do this yet.

https://twitter.com/mislav/status/1270388510684598272?s=21

The new default isn’t really set yet. Could be

• main
• default

Any thoughts?

[MiroDudik]

Thanks for bringing this up! I'm not a huge fan of default. I think I best like main.

Other options are develop (since we're using GitHub workflow), or latest, or current.

[hannawallach]

Yes, thank you! I like main too.

[romanlutz]

I’m still baffled that I never noticed this before :-(
I like all your suggestions @MiroDudik
Let’s see whether @adrinjalali @hildeweerts @kevinrobinson @koaning @MBrouns @riedgar-ms @rihorn2 or others have thoughts as well

[MBrouns]

I have a slight preference to trunk or develop, but don't have anything against main either.

[hannawallach]

One other thing I want to flag is that this relates to something that we'd discussed previously about having a dev or unstable branch and then a release or stable branch, so that folks can still make bigger changes even close to a release.

[riedgar-ms]

@hannawallach I do have a proposal out for making our versioning a bit more robust, and that includes starting to have release branches again:
fairlearn/fairlearn-proposals#11

As for a new name.... I think I'd prefer something like trunk or main to dev if we want to make sure that our main development is always ready-to-ship.

[romanlutz]

So many great suggestions! As a non-native English speaker I'm somewhat confused with trunk. It doesn't seem intuitive to me. Perhaps someone can explain this to me :-)

main seems to have the same kind of intuition as master but without the baggage. dev or develop are intuitive to me as well.

current or latest may be confusing because people may think that it reflects the version that they get when they run pip install fairlearn.

Maybe I'm overthinking this, but those are the thoughts I had when seeing these now.

[romanlutz]

Just came across this: https://github.com/dfm/rename-github-default-branch/blob/main/README.md

[MBrouns]

So many great suggestions! As a non-native English speaker I'm somewhat confused with trunk. It doesn't seem intuitive to me. Perhaps someone can explain this to me :-)

I think it came from SVN originally but I've always seen it as the trunk of a tree, from which branches spawn

[adrinjalali]

My only preference is to use what the rest of the community is gonna use since there are a bunch of scripts around which rely on the name of the "main" branch. It seems the community is converging on main which I'm happy with.

[hildeweerts]

I like main, but I'm happy with any of the other suggestions as well.

[riedgar-ms]

This implies that GitHub is going to go with main:
https://www.theregister.com/2020/06/15/github_replaces_master_with_main/
although I've not yet turned up an official announcement from the GitHub site yet, just the tweet.

Unless we really don't like their final choice, I suggest we stick to whatever is chosen by GitHub for the sake of simplicity.

[hildeweerts]

Does anybody know what GitHub is going to go with? I couldn't find any announcements dated later than June 15.

[adrinjalali]

AFAIK they haven't finished the work yet, so we don't know for sure, but I'm almost certain it's main.

In so far as the tasks go, I've compiled a list using the feedback I got from different places here: https://discuss.python.org/t/communitys-take-on-changing-master-branch-to-main/4462/12?u=adrinjalali

Not all of them are needed on this repo, but it's a good starting point.

[riedgar-ms]

Thanks for compiling that list of steps @adrinjalali . Funnily enough, we had an internal email this week saying that detailed instructions are coming. I expect there may be some automation on the GitHub side to take care of some of those (e.g. redoing any open PRs) although things like redoing the build definitions are going to remain manual.