Apply formatting
This will make sure we have a consistent style across our project and the PRs are only concerned with actual changes and no longer about style.
This commit is contained in:
@ -1,4 +1,5 @@
|
||||
# Contributing
|
||||
|
||||
[](https://github.com/WebGoat/WebGoat/graphs/contributors)
|
||||

|
||||

|
||||
@ -24,7 +25,7 @@ There are a couple of ways on how you can contribute to the project:
|
||||
Your PR is valuable to us, and to make sure we can integrate it smoothly, we have a few items for you to consider. In short:
|
||||
The minimum requirements for code contributions are:
|
||||
|
||||
1. The code _must_ be compliant with the configured Checkstyle and PMD rules.
|
||||
1. The code _must_ be compliant with the configured Java Google Formatter, Checkstyle and PMD rules.
|
||||
2. All new and changed code _should_ have a corresponding unit and/or integration test.
|
||||
3. New and changed lessons _must_ have a corresponding integration test.
|
||||
4. [Status checks](https://docs.github.com/en/github/collaborating-with-pull-requests/collaborating-on-repositories-with-code-quality-features/about-status-checks) should pass for your last commit.
|
||||
@ -38,14 +39,13 @@ Pull requests should be as small/atomic as possible. Large, wide-sweeping change
|
||||
* If you are making spelling corrections in the docs, don't modify other files.
|
||||
* If you are adding new functions don't '*cleanup*' unrelated functions. That cleanup belongs in another pull request.
|
||||
|
||||
|
||||
### Write a good commit message
|
||||
|
||||
* Explain why you make the changes. [More infos about a good commit message.](https://betterprogramming.pub/stop-writing-bad-commit-messages-8df79517177d)
|
||||
|
||||
* If you fix an issue with your commit, please close the issue by [adding one of the keywords and the issue number](https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue) to your commit message.
|
||||
|
||||
For example: `Fix #545` or `Closes #10`
|
||||
For example: `Fix #545` or `Closes #10`
|
||||
|
||||
## How to set up your Contributor Environment
|
||||
|
||||
@ -54,27 +54,34 @@ Pull requests should be as small/atomic as possible. Large, wide-sweeping change
|
||||
3. Clone your own repository to your host computer so that you can make modifications. If you followed the GitHub tutorial from step 2, you have already done this.
|
||||
4. Go to the newly cloned directory "WebGoat" and add the remote upstream repository:
|
||||
|
||||
```bash
|
||||
$ git remote -v
|
||||
origin git@github.com:<your Github handle>/WebGoat.git (fetch)
|
||||
origin git@github.com:<your Github handle>/WebGoat.git (push)
|
||||
```bash
|
||||
$ git remote -v
|
||||
origin git@github.com:<your Github handle>/WebGoat.git (fetch)
|
||||
origin git@github.com:<your Github handle>/WebGoat.git (push)
|
||||
|
||||
$ git remote add upstream git@github.com:WebGoat/WebGoat.git
|
||||
$ git remote add upstream git@github.com:WebGoat/WebGoat.git
|
||||
|
||||
$ git remote -v
|
||||
origin git@github.com:<your Github handle>/WebGoat.git (fetch)
|
||||
origin git@github.com:<your Github handle>/WebGoat.git (push)
|
||||
upstream git@github.com:OWASP/WebGoat.git (fetch)
|
||||
upstream git@github.com:OWASP/WebGoat.git (push)
|
||||
```
|
||||
$ git remote -v
|
||||
origin git@github.com:<your Github handle>/WebGoat.git (fetch)
|
||||
origin git@github.com:<your Github handle>/WebGoat.git (push)
|
||||
upstream git@github.com:OWASP/WebGoat.git (fetch)
|
||||
upstream git@github.com:OWASP/WebGoat.git (push)
|
||||
```
|
||||
|
||||
See also the GitHub documentation on "[Configuring a remote for a fork](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/configuring-a-remote-for-a-fork "Configuring a remote for a fork")".
|
||||
|
||||
See also the GitHub documentation on "[Configuring a remote for a fork](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/configuring-a-remote-for-a-fork "Configuring a remote for a fork")".
|
||||
5. Choose what to work on, based on any of the outstanding [issues](https://github.com/WebGoat/WebGoat/issues "WebGoat Issues").
|
||||
|
||||
6. Create a branch so that you can cleanly work on the chosen issue: `git checkout -b FixingIssue66`
|
||||
|
||||
7. Open your favorite editor and start making modifications. We recommend using the [IntelliJ Idea](https://www.jetbrains.com/idea/).
|
||||
|
||||
8. After your modifications are done, push them to your forked repository. This can be done by executing the command `git add MYFILE` for every file you have modified, followed by `git commit -m 'your commit message here'` to commit the modifications and `git push` to push your modifications to GitHub.
|
||||
|
||||
9. Create a Pull Request (PR) by going to your fork, <https://github.com/Your_Github_Handle/WebGoat> and click on the "New Pull Request" button. The target branch should typically be the Master branch. When submitting a PR, be sure to follow the checklist that is provided in the PR template. The checklist itself will be filled out by the reviewer.
|
||||
|
||||
10. Your PR will be reviewed and comments may be given. In order to process a comment, simply make modifications to the same branch as before and push them to your repository. GitHub will automatically detect these changes and add them to your existing PR.
|
||||
|
||||
11. When starting on a new PR in the future, make sure to always keep your local repo up to date:
|
||||
|
||||
```bash
|
||||
|
Reference in New Issue
Block a user