Rename branch "master" to "main"

kptdobe commented 4 years ago

Adobe Engineering Council decided that master branch should be renamed to main. 2 main operations are required to be performed for each of our repos:

create the main branch, make it the default branch and delete the master branch. See here for easy step-by-step instructions.
in the code, search and replace all occurrences of master by main, at least when master refers to a branch name (which is often the case in Helix since we use the master branch as default to find content and code during rendering).

stefan-guggisberg commented 4 years ago

trieloff commented 4 years ago

We can rename our branches to main right away, but changing the assumption that the default branch is main will break things (for all customer repos that have been created before GitHub changed the defaults). Isn't there a way to determine the default branch name in GitHub?

kptdobe commented 4 years ago

Correct, we have to be careful with the "code" part of the work: we'll have to support for a certain time 2 potential default branch name: master and main. GitHub said they will change the default default branch to main thus at one point, new customer repos will come with main. Once GitHub makes the change, if we drop master, we break backward comp (2 options then: either we migrate all existing customer repos or we support both).

https://developer.github.com/v3/repos/#get-a-repository gives the default_branch.

tripodsan commented 4 years ago

supporting both will be a bit tricky, since the fallback to master is at many places. like in the VCL, when the first part of a helix pages project is missing. we should probably remove all fallbacks and try to default as late as possible. maybe resolve-git-ref can figure out the default automatically? @stefan-guggisberg ?

stefan-guggisberg commented 4 years ago

@tripodsan I created an issue: adobe/helix-resolve-git-ref#253

tripodsan commented 4 years ago

see https://github.com/github/renaming

rofe commented 3 years ago

I changed the helix-home default branch to main, but left the master branch for now because Helix Pages still expects it when no branch is specified in the URL, e.g. https://helix-home--adobe.hlx.page/getting-started.html

dominique-pfister commented 3 years ago

[x] helix-onedrive-cli
[x] helix-onedrive-listener
[x] helix-onedrive-support
[x] helix-index-files
[x] helix-index-pipelines
[x] helix-observation-cli
[x] helix-param-checker
[x] helix-task-support
[x] helix-task-worker
[x] helix-task-controller

rofe commented 3 years ago

So cool! Thanks @dominique-pfister

tripodsan commented 3 years ago

updated list:

tripodsan commented 2 years ago

closing - helix-pages is the last one, which will we can rename, once helix2 doesn't need it anymore.

adobe / helix-home

Rename branch "master" to "main" #140