forked from WebGoat/WebGoat
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
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.
- Loading branch information
Showing
336 changed files
with
14,087 additions
and
12,854 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -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 [email protected]:<your Github handle>/WebGoat.git (fetch) | ||
origin [email protected]:<your Github handle>/WebGoat.git (push) | ||
```bash | ||
$ git remote -v | ||
origin [email protected]:<your Github handle>/WebGoat.git (fetch) | ||
origin [email protected]:<your Github handle>/WebGoat.git (push) | ||
|
||
$ git remote add upstream [email protected]:WebGoat/WebGoat.git | ||
$ git remote add upstream [email protected]:WebGoat/WebGoat.git | ||
|
||
$ git remote -v | ||
origin [email protected]:<your Github handle>/WebGoat.git (fetch) | ||
origin [email protected]:<your Github handle>/WebGoat.git (push) | ||
upstream [email protected]:OWASP/WebGoat.git (fetch) | ||
upstream [email protected]:OWASP/WebGoat.git (push) | ||
``` | ||
$ git remote -v | ||
origin [email protected]:<your Github handle>/WebGoat.git (fetch) | ||
origin [email protected]:<your Github handle>/WebGoat.git (push) | ||
upstream [email protected]:OWASP/WebGoat.git (fetch) | ||
upstream [email protected]: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 | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1 +1 @@ | ||
Thank you for submitting a pull request to the WebGoat! | ||
Thank you for submitting a pull request to the WebGoat! |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -2,4 +2,3 @@ | |
|
||
Old GitHub page which now redirects to OWASP website. | ||
|
||
|
Oops, something went wrong.