0ed0799e23
* docs(contributing): fix branch naming convention
Documented `fix/123` didn't match actual team practice.
Real convention uses domain suffix: `fix-#{issue}-{domain}`.
* docs(contributing): add commit message format
Team uses `Fix #N domain` / `Upd #N domain` convention
but it wasn't documented for external contributors.
* docs(contributing): add rule placement conventions
Implicit team practices not previously documented:
new rules at section top, domain insertion at list
beginning/end, group consistency for same-domain rules.
* docs: update branch naming convention to slash-separated format
https://github.com/AdguardTeam/AdguardFilters/pull/230176#discussion_r3225315534
* docs: reword rule placement heading sentence
https://github.com/AdguardTeam/AdguardFilters/pull/230176#discussion_r3225834464
* docs: clarify same-domain group insertion wording
https://github.com/AdguardTeam/AdguardFilters/pull/230176#discussion_r3225858467
* docs: add group comment to same-domain code example
https://github.com/AdguardTeam/AdguardFilters/pull/230176#discussion_r3225881989
* docs: bold "beginning" and "at the end" separately
https://github.com/AdguardTeam/AdguardFilters/pull/230176#discussion_r3225964987
* docs: replace separate examples with combined mixed-type diff
https://github.com/AdguardTeam/AdguardFilters/pull/230176#discussion_r3226023924
* docs: remove label instruction
Regular users can't change the label: https://github.com/AdguardTeam/AdguardFilters/pull/230176#discussion_r3226041465
* docs: restructure mixed-type rule placement example
Moves the combined mixed-type diff after the type-specific examples
so readers see the individual rules first, then the override.
Adds a brief reason: only the separator differs (`,` vs `|`),
so consistent ordering makes missing domains immediately visible.
https://github.com/AdguardTeam/AdguardFilters/pull/230176#discussion_r3233231097
* docs: clarify fix vs upd branch prefix distinction
https://github.com/AdguardTeam/AdguardFilters/pull/230176#discussion_r3233187977
* docs: tighten same-rule-expression domain placement bullet
Prevents contributors from adding the domain as a new rule
on a separate line by making the instruction explicit.
https://github.com/AdguardTeam/AdguardFilters/pull/230176#discussion_r3233231097
* better without "or follow-ups"
Co-authored-by: Alex <alex302@adguard.com>
* If the rule applies to a site for which a rules group exists...
Co-authored-by: Alex <alex302@adguard.com>
* Add "depending on the type of rule"
Co-authored-by: Alex <alex302@adguard.com>
* For "cosmetic" rules
Co-authored-by: Alex <alex302@adguard.com>
* Update CONTRIBUTING.md
Co-authored-by: Alex <alex302@adguard.com>
* Update CONTRIBUTING.md
Co-authored-by: Alex <alex302@adguard.com>
* Update CONTRIBUTING.md
Co-authored-by: Alex <alex302@adguard.com>
* Remove the avoid notice
Co-authored-by: Alex <alex302@adguard.com>
* moved above
Co-authored-by: Alex <alex302@adguard.com>
* Update CONTRIBUTING.md
Co-authored-by: Alex <alex302@adguard.com>
* Update CONTRIBUTING.md
Co-authored-by: Alex <alex302@adguard.com>
* Update CONTRIBUTING.md
Co-authored-by: Alex <alex302@adguard.com>
* Fixed linter warnings
---------
Co-authored-by: Alex <alex302@adguard.com>
AdGuard Filters
The place where ad trackers are actually blocked
This is the place where we create filters for AdGuard and other ad-blocking software, such as uBlock Origin. Each filter consists of a set of text-based rules that AdGuard apps and programs use to filter out advertisements and privacy-invasive content like banners, pop-ups, and trackers. Rules specific to a certain region (e.g., German filter, Russian filter) or serving a specific purpose (e.g., Social Media filter, Tracking Protection filter) are combined into a single list, or filter, that can be enabled or disabled all at once.
Our filters are constantly updated. This repository allows anyone to bring our attention to anything from overlooked ads to false positives, helping us refine our filters, improve them, and keep them current.
We are proud of the fact that AdGuard Filters are among the most actively developed content-blocking filter lists available, if not the most.
AdGuard Filters Policy
Our filter policy is available here.
Contributing to AdGuard
We are blessed to have a community that does not only love AdGuard, but also gives back. A lot of people volunteer in various ways to make other users' experience with AdGuard better, and you can join them! We, on our part, can only be happy to reward the most active members of the community. So, what can you do?
Report Issues
To submit a report, please use this reporting tool.
Suggest Filtering Rules
You will find a lot of open issues, each one referencing a problem with some website — a missed ad, a false positive etc. — choose any one and suggest your own rules in comments. AdGuard filter engineers will review your suggestions, and if they find them correct, your rules will be added to AdGuard filters.
Here is the official documentation on AdGuard filtering rules syntax. You'll need to read it before you'll be able to create your own filtering rules.
Other ways to contribute
Here is a dedicated page for people willing to contribute to AdGuard.