Skip to content

Commit 0757aac

Browse files
authored
Use current main branch in docs instead of master (#1322)
1 parent 00f0efa commit 0757aac

File tree

4 files changed

+19
-19
lines changed

4 files changed

+19
-19
lines changed

.github/workflows/pr-build-workflow.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@ name: Pull Request build
22

33
on:
44
pull_request:
5-
branches: [ master ]
5+
branches: [ main ]
66

77
jobs:
88
build:

CONTRIBUTING.adoc

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ _you should see only 'origin' - which is the fork you created for your own githu
4747
_you should now see 'upstream' in addition to 'origin' where 'upstream' is the Spring repository from which releases are built_
4848
6. `git fetch --all`
4949
7. `git branch -a`
50-
_you should see branches on origin as well as upstream, including 'master' and 'maint'_
50+
_you should see branches on origin as well as upstream, including 'main' and 'maint'_
5151

5252
== A Day in the Life of a Contributor
5353

@@ -61,37 +61,37 @@ e.g.: `git push origin GH-123`
6161
* If you want to collaborate with another contributor, have them fork your repository (add it as a remote) and `git fetch <your-username>` to grab your branch.
6262
Alternatively, they can use `git fetch --all` to sync their local state with all of their remotes.
6363
* If you grant those collaborator(s) push access to your repository, they can even apply their changes to your branch.
64-
* When ready for your contribution to be reviewed for potential inclusion in the master branch of the canonical spring-amqp repository (what you know as 'upstream'), issue a pull request to the SpringSource repository (for more detail, see https://help.github.com/articles/using-pull-requests/[Using pull requests]).
65-
* The project lead may merge your changes into the upstream master branch as-is, he may keep the pull request open yet add a comment about something that should be modified, or he might reject the pull request by closing it.
66-
* A prerequisite for any pull request is that it will be cleanly merge-able with the upstream master's current state.
64+
* When ready for your contribution to be reviewed for potential inclusion in the main branch of the canonical spring-amqp repository (what you know as 'upstream'), issue a pull request to the SpringSource repository (for more detail, see https://help.github.com/articles/using-pull-requests/[Using pull requests]).
65+
* The project lead may merge your changes into the upstream main branch as-is, he may keep the pull request open yet add a comment about something that should be modified, or he might reject the pull request by closing it.
66+
* A prerequisite for any pull request is that it will be cleanly merge-able with the upstream main's current state.
6767
**This is the responsibility of any contributor.**
6868
If your pull request cannot be applied cleanly, the project lead will most likely add a comment requesting that you make it merge-able.
6969
For a full explanation, see https://git-scm.com/book/en/Git-Branching-Rebasing[the Pro Git section on rebasing].
7070
As stated there: _"> Often, you’ll do this to make sure your commits apply cleanly on a remote branch — perhaps in a project to which you’re trying to contribute but that you don’t maintain."_
7171

7272
== Keeping your Local Code in Sync
73-
* As mentioned above, you should always work on topic branches (since 'master' is a moving target). However, you do want to always keep your own 'origin' master branch in synch with the 'upstream' master.
73+
* As mentioned above, you should always work on topic branches (since 'main' is a moving target). However, you do want to always keep your own 'origin' main branch in synch with the 'upstream' main.
7474
* Within your local working directory, you can sync up all remotes' branches with: `git fetch --all`
75-
* While on your own local master branch: `git pull upstream master` (which is the equivalent of fetching upstream/master and merging that into the branch you are in currently)
75+
* While on your own local main branch: `git pull upstream main` (which is the equivalent of fetching upstream/main and merging that into the branch you are in currently)
7676
* Now that you're in synch, switch to the topic branch where you plan to work, e.g.: `git checkout -b AMQP-123`
7777
* When you get to a stopping point: `git commit`
78-
* If changes have occurred on the upstream/master while you were working you can synch again:
79-
- Switch back to master: `git checkout master`
80-
- Then: `git pull upstream master`
78+
* If changes have occurred on the upstream/main while you were working you can synch again:
79+
- Switch back to main: `git checkout main`
80+
- Then: `git pull upstream main`
8181
- Switch back to the topic branch: `git checkout AMQP-123` (no -b needed since the branch already exists)
82-
- Rebase the topic branch to minimize the distance between it and your recently synched master branch: `git rebase master`
82+
- Rebase the topic branch to minimize the distance between it and your recently synched main branch: `git rebase main`
8383
(Again, for more detail see https://git-scm.com/book/en/Git-Branching-Rebasing[the Pro Git section on rebasing]).
84-
* **Note** While it is generally recommended to __not__ re-write history by using `push --force`, and we do not do this on `master` (and release) branches in the main repo, we require topic branches for pull requests to be rebased before merging, in order to maintain a clean timeline and avoid "merge" commits.
84+
* **Note** While it is generally recommended to __not__ re-write history by using `push --force`, and we do not do this on `main` (and release) branches in the main repo, we require topic branches for pull requests to be rebased before merging, in order to maintain a clean timeline and avoid "merge" commits.
8585
* If, while rebasing for the merge, we find significant conflicts, we may ask you to rebase and `push --force` to your topic branch after resolving the conflicts.
86-
* Assuming your pull request is merged into the 'upstream' master, you will actually end up pulling that change into
87-
your own master eventually, and at that time, you may decide to delete the topic branch from your local repository and
86+
* Assuming your pull request is merged into the 'upstream' main, you will actually end up pulling that change into
87+
your own main eventually, and at that time, you may decide to delete the topic branch from your local repository and
8888
your fork (origin) if you pushed it there.
8989
- to delete the local branch: `git branch -d GH-123`
9090
- to delete the branch from your origin: `git push origin :GH-123`
9191

9292
== Maintain a linear commit history
9393

94-
When merging to master, the project __always__ uses fast-forward merges.
94+
When merging to main, the project __always__ uses fast-forward merges.
9595
When issuing pull requests, please ensure that your commit history is linear.
9696
From the command line you can check this using:
9797

@@ -117,7 +117,7 @@ This command, will provide the following output, which in this case shows a nice
117117
----
118118

119119
If you see intersecting lines, that usually means that you forgot to rebase you branch.
120-
As mentioned earlier, **please rebase against master** before issuing a pull request.
120+
As mentioned earlier, **please rebase against main** before issuing a pull request.
121121

122122
== Mind the whitespace
123123

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
Spring AMQP [<img src="https://build.spring.io/plugins/servlet/wittified/build-status/AMQP-MASTER">](https://build.spring.io/browse/AMQP-MASTER) [![Join the chat at https://gitter.im/spring-projects/spring-amqp](https://badges.gitter.im/spring-projects/spring-amqp.svg)](https://gitter.im/spring-projects/spring-amqp?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
1+
Spring AMQP [<img src="https://build.spring.io/plugins/servlet/wittified/build-status/AMQP-MAIN">](https://build.spring.io/browse/AAMQP-MAIN) [![Join the chat at https://gitter.im/spring-projects/spring-amqp](https://badges.gitter.im/spring-projects/spring-amqp.svg)](https://gitter.im/spring-projects/spring-amqp?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
22
===========
33

44
This project provides support for using Spring and Java with [AMQP 0.9.1](https://www.rabbitmq.com/amqp-0-9-1-reference.html), and in particular [RabbitMQ](https://www.rabbitmq.com/).
@@ -115,7 +115,7 @@ None of these is essential for a pull request, but they will all help. They can
115115
* Add yourself as an @author to the .java files that you modify substantially (more than cosmetic changes).
116116
* Add some Javadocs and, if you change the namespace, some XSD doc elements.
117117
* A few unit tests would help a lot as well - someone has to do it.
118-
* If no-one else is using your branch, please rebase it against the current master (or other target branch in the main project).
118+
* If no-one else is using your branch, please rebase it against the current main (or other target branch in the main project).
119119

120120
# License
121121

src/dist/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -114,7 +114,7 @@ None of these is essential for a pull request, but they will all help. They can
114114
* Add yourself as an @author to the .java files that you modify substantially (more than cosmetic changes).
115115
* Add some Javadocs and, if you change the namespace, some XSD doc elements.
116116
* A few unit tests would help a lot as well - someone has to do it.
117-
* If no-one else is using your branch, please rebase it against the current master (or other target branch in the main project).
117+
* If no-one else is using your branch, please rebase it against the current main (or other target branch in the main project).
118118

119119
# License
120120

0 commit comments

Comments
 (0)