mirror of
https://github.com/kata-containers/kata-containers.git
synced 2025-09-01 17:06:28 +00:00
contributing: Update outdated repo branch name
Update master to main in instructions and relevant links. Fixes #283 Signed-off-by: Chelsea Mafrica <chelsea.e.mafrica@intel.com>
This commit is contained in:
@@ -184,7 +184,7 @@ $ mkdir -p "$GOPATH"
|
|||||||
```
|
```
|
||||||
|
|
||||||
For further details on `golang`, refer to the
|
For further details on `golang`, refer to the
|
||||||
[requirements section of the Kata Developer Guide](https://github.com/kata-containers/documentation/blob/master/Developer-Guide.md#requirements-to-build-individual-components).
|
[requirements section of the Kata Developer Guide](https://github.com/kata-containers/kata-containers/blob/main/docs/Developer-Guide.md#requirements-to-build-individual-components).
|
||||||
|
|
||||||
>*Note*: If you intend to make minor edits, it's acceptable
|
>*Note*: If you intend to make minor edits, it's acceptable
|
||||||
> to simply fork and clone without adding the GOPATH variable.
|
> to simply fork and clone without adding the GOPATH variable.
|
||||||
@@ -247,7 +247,7 @@ For more details, see how to [set up a git remote](https://help.github.com/artic
|
|||||||
$ git checkout -b fix-contrib-bugs
|
$ git checkout -b fix-contrib-bugs
|
||||||
```
|
```
|
||||||
|
|
||||||
>**Warning:** *Never* make changes directly to the `master` branch
|
>**Warning:** *Never* make changes directly to the `main` branch
|
||||||
>--*always* create a new "topic branch" for PR work.
|
>--*always* create a new "topic branch" for PR work.
|
||||||
|
|
||||||
1. Make some editorial changes. In this example, we modify the file that
|
1. Make some editorial changes. In this example, we modify the file that
|
||||||
@@ -302,7 +302,7 @@ commits you created to apply the review changes to your branch. Your branch
|
|||||||
now looks something like this:
|
now looks something like this:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
$ git log master.. --oneline --decorate=no
|
$ git log main.. --oneline --decorate=no
|
||||||
4928d57 docs: Fix typos and fold long lines
|
4928d57 docs: Fix typos and fold long lines
|
||||||
829c6c8 apply review feedback changes
|
829c6c8 apply review feedback changes
|
||||||
7c9b1b2 remove blank lines
|
7c9b1b2 remove blank lines
|
||||||
@@ -310,7 +310,7 @@ $ git log master.. --oneline --decorate=no
|
|||||||
```
|
```
|
||||||
|
|
||||||
>**Note:** The `git log` command compares your current branch
|
>**Note:** The `git log` command compares your current branch
|
||||||
>(`fix-contrib-bugs`) with the `master` branch and lists all the commits,
|
>(`fix-contrib-bugs`) with the `main` branch and lists all the commits,
|
||||||
>one per line.
|
>one per line.
|
||||||
|
|
||||||
#### Git rebase if multiple commits
|
#### Git rebase if multiple commits
|
||||||
@@ -320,13 +320,13 @@ combine all four commits into a *single commit* on your PR. You need to
|
|||||||
[git rebase](https://help.github.com/github/using-git/about-git-rebase)
|
[git rebase](https://help.github.com/github/using-git/about-git-rebase)
|
||||||
multiple commits on your branch. Follow these steps.
|
multiple commits on your branch. Follow these steps.
|
||||||
|
|
||||||
1. Update the `master` branch in your local copy of the upstream
|
1. Update the `main` branch in your local copy of the upstream
|
||||||
repository:
|
repository:
|
||||||
|
|
||||||
```
|
```
|
||||||
$ cd $GOPATH/src/github.com/kata-containers/community
|
$ cd $GOPATH/src/github.com/kata-containers/community
|
||||||
$ git checkout master
|
$ git checkout main
|
||||||
$ git pull --rebase upstream master
|
$ git pull --rebase upstream main
|
||||||
```
|
```
|
||||||
|
|
||||||
The previous command downloads all the latest changes from the upstream
|
The previous command downloads all the latest changes from the upstream
|
||||||
@@ -338,10 +338,10 @@ multiple commits on your branch. Follow these steps.
|
|||||||
$ git checkout fix-contrib-bugs
|
$ git checkout fix-contrib-bugs
|
||||||
```
|
```
|
||||||
|
|
||||||
1. Rebase your changes against the `master` branch.
|
1. Rebase your changes against the `main` branch.
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
$ git rebase -i master
|
$ git rebase -i main
|
||||||
```
|
```
|
||||||
|
|
||||||
Example output:
|
Example output:
|
||||||
@@ -378,7 +378,7 @@ multiple commits on your branch. Follow these steps.
|
|||||||
running the `git log` command again:
|
running the `git log` command again:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
$ git log master.. --oneline --decorate=no
|
$ git log main.. --oneline --decorate=no
|
||||||
3ea3aef docs: Fix typo
|
3ea3aef docs: Fix typo
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -391,7 +391,7 @@ multiple commits on your branch. Follow these steps.
|
|||||||
|
|
||||||
>**Note:** Not only does this command upload your changes to your fork, it
|
>**Note:** Not only does this command upload your changes to your fork, it
|
||||||
>also includes the *latest upstream changes* to your fork since you ran
|
>also includes the *latest upstream changes* to your fork since you ran
|
||||||
>`git pull --rebase upstream master` on the master branch and then merged
|
>`git pull --rebase upstream main` on the main branch and then merged
|
||||||
>those changes into your PR branch. This ensures your fork is now "up to
|
>those changes into your PR branch. This ensures your fork is now "up to
|
||||||
>date" with the upstream repository. The `-f` option is a "force push". Since
|
>date" with the upstream repository. The `-f` option is a "force push". Since
|
||||||
>you created a new commit using `git rebase`, you must "overwrite" the old
|
>you created a new commit using `git rebase`, you must "overwrite" the old
|
||||||
@@ -433,7 +433,7 @@ automatically blocked from merging.
|
|||||||
|
|
||||||
If you raise a PR to update the vendored copy of one or more golang packages,
|
If you raise a PR to update the vendored copy of one or more golang packages,
|
||||||
after running the
|
after running the
|
||||||
[`dep`](https://github.com/kata-containers/community/blob/master/VENDORING.md) command, ensure you add any modified files under the `vendor/` directory to Git before committing the changes:
|
[`dep`](https://github.com/kata-containers/community/blob/main/VENDORING.md) command, ensure you add any modified files under the `vendor/` directory to Git before committing the changes:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
$ git add vendor/
|
$ git add vendor/
|
||||||
@@ -482,13 +482,13 @@ body:
|
|||||||
read.
|
read.
|
||||||
|
|
||||||
For additional information on using the `dep` tool, see
|
For additional information on using the `dep` tool, see
|
||||||
"[Performing vendoring for the Kata Containers project](https://github.com/kata-containers/community/blob/master/VENDORING.md)".
|
"[Performing vendoring for the Kata Containers project](https://github.com/kata-containers/community/blob/main/VENDORING.md)".
|
||||||
|
|
||||||
## Use static checks for validation
|
## Use static checks for validation
|
||||||
|
|
||||||
* Kata Containers utilizes [Continuous Integration (CI)](#continuous-integration) to automatically check every PR.
|
* Kata Containers utilizes [Continuous Integration (CI)](#continuous-integration) to automatically check every PR.
|
||||||
|
|
||||||
* We strongly encourage you to run the same CI tests on individual PRs, using [static checks](https://github.com/kata-containers/tests/blob/master/.ci/static-checks.sh)
|
* We strongly encourage you to run the same CI tests on individual PRs, using [static checks](https://github.com/kata-containers/tests/blob/main/.ci/static-checks.sh)
|
||||||
|
|
||||||
In repositories where a `Makefile` is present, you can execute
|
In repositories where a `Makefile` is present, you can execute
|
||||||
static checks for testing and development. To do so, invoke the `make check` and `make test` rules, after developer mode is enabled.
|
static checks for testing and development. To do so, invoke the `make check` and `make test` rules, after developer mode is enabled.
|
||||||
@@ -535,7 +535,7 @@ view its build logs to determine the cause of failure.
|
|||||||
|
|
||||||
If working on `kata-runtime`, first ensure you run `make` and `make install`
|
If working on `kata-runtime`, first ensure you run `make` and `make install`
|
||||||
in the `virtcontainers` subdirectory, as shown below. For more information,
|
in the `virtcontainers` subdirectory, as shown below. For more information,
|
||||||
see [virtcontainers](https://github.com/kata-containers/runtime/blob/master/virtcontainers/documentation/Developers.md#testing).
|
see [virtcontainers](https://github.com/kata-containers/kata-containers/blob/main/src/runtime/virtcontainers/documentation/Developers.md#testing).
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
$ pushd runtime/virtcontainers
|
$ pushd runtime/virtcontainers
|
||||||
@@ -586,7 +586,7 @@ type of PR the user is raising.
|
|||||||
> **Notes:**
|
> **Notes:**
|
||||||
>
|
>
|
||||||
> - The porting labels are enforced by a
|
> - The porting labels are enforced by a
|
||||||
> [GitHub action](https://github.com/kata-containers/.github/blob/master/scripts/pr-porting-checks.sh).
|
> [GitHub action](https://github.com/kata-containers/.github/blob/main/scripts/pr-porting-checks.sh).
|
||||||
> This means that *PRs that do not have a valid set of porting labels cannot be merged*.
|
> This means that *PRs that do not have a valid set of porting labels cannot be merged*.
|
||||||
> - The "Common PR type" column in the table shows the most likely type of PR, but
|
> - The "Common PR type" column in the table shows the most likely type of PR, but
|
||||||
> this is just a guide.
|
> this is just a guide.
|
||||||
@@ -618,7 +618,7 @@ porting activities.
|
|||||||
### Stable branch backports
|
### Stable branch backports
|
||||||
|
|
||||||
Kata Containers maintains a number of stable branch releases. Bug fixes to
|
Kata Containers maintains a number of stable branch releases. Bug fixes to
|
||||||
the master branch are selectively applied to (or "backported") these stable branches.
|
the main branch are selectively applied to (or "backported") these stable branches.
|
||||||
|
|
||||||
In order to aid identification of commits that potentially should be
|
In order to aid identification of commits that potentially should be
|
||||||
backported to the stable branches, all PRs submitted must be labeled with
|
backported to the stable branches, all PRs submitted must be labeled with
|
||||||
|
Reference in New Issue
Block a user