Awesome-WAF/CONTRIBUTING.md

99 lines
5.0 KiB
Markdown
Raw Permalink Normal View History

2019-02-07 19:57:48 +07:00
I appreciate and recognize [all contributors](https://github.com/0xInfection/awesome-waf/graphs/contributors).
2019-02-26 14:34:28 +07:00
> First of all thank you for even considering of contributing to this awesome list. __"The community just learns from each other"__.
2019-02-07 19:57:48 +07:00
2019-02-26 14:34:28 +07:00
## Table of Contents
2019-02-07 19:57:48 +07:00
2019-02-26 14:34:28 +07:00
- [Contribution guidelines](#contribution-guidelines)
2019-02-07 19:57:48 +07:00
- [Quality Standard](#quality-standard)
- [Adding to this list](#adding-to-this-list)
- [Adding something to an awesome list](#adding-something-to-an-awesome-list)
- [Updating your Pull Request](#updating-your-pull-request)
2019-02-26 14:34:28 +07:00
## Contribution Guidelines
2019-02-07 19:57:48 +07:00
2019-02-26 14:34:28 +07:00
__Your pull request/commit message will be a tweet, please keep that in mind.__ :)
2019-02-07 19:57:48 +07:00
- **To add to the list:** Submit a pull request.
- **To remove from the list:** Submit a pull request.
- Want to change something: Submit a pull request.
- Want to try something else: Submit a pull request.
- Don't know what to do: Submit a pull request or open an issue, let me know what's going on.
2019-02-26 14:34:28 +07:00
[Awesome-WAF](https://github.com/0xinfection/awesome-waf) is a hand-crafted list for high-quality information about web application firewalls and its resources. Following items are recommended to be kept in mind.
2019-02-07 19:57:48 +07:00
2019-03-13 14:37:27 +07:00
- If you are submitting a new fingerprint, include the headers/page source, etc.
- Do not include the URL as it may expose the integrity of the site.
> I will contact you personally if necessary via email.
- Item you're adding should not be duplicate, no redirection (be careful with `http` vs `https`!).
2019-02-07 19:57:48 +07:00
- The link should be the name of the slide or project or website.
- Description should be clear and concise (read it out loud to be sure).
- Description should follow the link, on the same line.
- if you want to add more than one link, please don't do all PR on the exact same line, it usually results in conflicts and your PR cannot be automatically merged.
2019-02-26 14:34:28 +07:00
Please contribute links to slides/tools you have used or are familiar with. This will help ensure high-quality entries.
2019-02-07 19:57:48 +07:00
2019-02-26 14:34:28 +07:00
## Quality Standard
2019-02-07 19:57:48 +07:00
Note that we can help you achieve those standards, just try your best, be brave.
We'll guide you to the best of our abilities.
To be on the list, it would be *nice* if entries adhere to these quality standards:
2019-03-13 14:37:27 +07:00
- Generally useful to the community.
2019-02-07 19:57:48 +07:00
- Clearly stating "what is it for": mention the problem it solves. Just try your best, make it clear for the next person.
- Solves a real problem (even a small one)
2019-02-26 14:34:28 +07:00
- If your PR is a **WIP** (work in progress, not safe for production), mention it.
2019-02-07 19:57:48 +07:00
2019-02-26 14:34:28 +07:00
If your PR is not merged, I will tell you why so that you may be able to improve it.
2019-02-07 19:57:48 +07:00
2019-03-13 14:37:27 +07:00
## Contribution Guidelines
2019-02-07 19:57:48 +07:00
2019-02-26 14:34:28 +07:00
### Adding to this List
2019-02-07 19:57:48 +07:00
Please ensure your pull request adheres to the following guidelines:
- Search previous suggestions before making a new one, as yours may be a duplicate.
- Make sure the list is useful before submitting. That implies it has enough content and every item has a good succinct description.
- Make an individual pull request for each suggestion.
- Use [title-casing](http://titlecapitalization.com) (AP style).
- Use the following format: `[List Name](link)`
- Link additions should be added to the bottom of the relevant category.
- New categories or improvements to the existing categorization are welcome.
- Check your spelling and grammar.
- Make sure your text editor is set to remove trailing whitespace.
- The pull request and commit should have a useful title.
- The body of your commit message should contain a link to the repository.
2019-02-26 14:34:28 +07:00
Thank you for your contributions!
2019-02-07 19:57:48 +07:00
2019-02-26 14:34:28 +07:00
### Adding something to an Awesome List
2019-02-07 19:57:48 +07:00
If you have something awesome to contribute to an awesome list, this is how you do it.
You'll need a [GitHub account](https://github.com/join)!
1. Access the awesome list's GitHub page. For example: https://github.com/sindresorhus/awesome
2. Click on the `readme.md` file:
![Step 2 Click on Readme.md](https://cloud.githubusercontent.com/assets/170270/9402920/53a7e3ea-480c-11e5-9d81-aecf64be55eb.png)
3. Now click on the edit icon.
![Step 3 - Click on Edit](https://cloud.githubusercontent.com/assets/170270/9402927/6506af22-480c-11e5-8c18-7ea823530099.png)
4. You can start editing the text of the file in the in-browser editor. Make sure you follow guidelines above. You can use [GitHub Flavored Markdown](https://help.github.com/articles/github-flavored-markdown/).
![Step 4 - Edit the file](https://cloud.githubusercontent.com/assets/170270/9402932/7301c3a0-480c-11e5-81f5-7e343b71674f.png)
5. Say why you're proposing the changes, and then click on "Propose file change".
![Step 5 - Propose Changes](https://cloud.githubusercontent.com/assets/170270/9402937/7dd0652a-480c-11e5-9138-bd14244593d5.png)
6. Submit the [pull request](https://help.github.com/articles/using-pull-requests/)!
2019-02-26 14:34:28 +07:00
### Updating your Pull Request
2019-02-07 19:57:48 +07:00
Sometimes, a maintainer of an awesome list will ask you to edit your Pull Request before it is included. This is normally due to spelling errors or because your PR didn't match the awesome-* list guidelines.
[Here](https://github.com/RichardLitt/knowledge/blob/master/github/amending-a-commit-guide.md) is a write up on how to change a Pull Request, and the different ways you can do that.