[mapserver-dev] Motion: rename default 'master' branch to 'main'

Jeff McKenna jmckenna at gatewaygeomatics.com
Wed Jan 13 13:47:26 PST 2021

Sounds good for testing one repository (and yes to Jerome/MapCache and 
Bruno's request for other projects under the MapServer umbrella). 
Honestly I'm most worried of impacts of the website publishing process, 
but since it is based on a branch other than master it should be ok, but 
I agree to test on 'mapserver-demo'.  Maybe this Friday will be the day 
to test.

(it should be 'easy', but with any change like this there must be some 
undocumented impacts - such as updating the docs for 'master' references 
etc - there will definitely be impacts like that coming, and will try to 
fix them as fast as possible)


On 2021-01-13 4:50 p.m., Steve Lime wrote:
> +1 but would it make sense to try with one of the lesser projects (e.g. 
> mapserver-demo) first? That is, before pushing the big red button - fork 
> it, clone it locally, clone the fork and then push the button - and then 
> document the changes necessary to recover.
> --Steve
> On Tue, Jan 12, 2021 at 2:54 PM Jeff McKenna 
> <jmckenna at gatewaygeomatics.com <mailto:jmckenna at gatewaygeomatics.com>> 
> wrote:
>     Hi PSC,
>     Some may remember a past discussion here about possibly renaming our
>     'master' branch to a less insensitive name as 'main'.  It was
>     decided to
>     wait a bit, as Github stated that by January 2021 it would make it
>     easier to change the default branch name
>     (https://github.com/github/renaming
>     <https://github.com/github/renaming>).
>     I have checked our settings today and indeed it is now possible through
>     the regular settings.
>     For our code repository, 'MapServer', here is the dialog window before
>     pressing the 'rename branch' button:
>     https://pasteboard.co/JJlr3xy.png <https://pasteboard.co/JJlr3xy.png>
>     For those not wanting to click an external link, it states that Github
>     will automatically:
>     - update 8 pull requests targeting this branch across 6 repositories
>     - update 1 branch protection rule that explicitly targets 'master'
>     *note that renaming this branch will not update your members' local
>     environments
>     For our documentation repository, 'MapServer-documentation', here is
>     the
>     dialog window before pressing the 'rename branch' button:
>     https://pasteboard.co/JJluDt6.png <https://pasteboard.co/JJluDt6.png>
>     As you can see the impacts on the documentation are less because there
>     are no open pull requests etc.
>     So, it is a good time to move forward with this.  Could there be some
>     other impacts?  Possibly, but I believe it is worth trying now, and we
>     can adapt if necessary.
>     I motion to rename the default 'master' branch to 'main' for the
>     MapServer and MapServer-documentation repositories.
>     I'll start with a +1
>     PS. happy 2021 to everyone
>     -jeff

More information about the mapserver-dev mailing list