From 214ff5a93c416dbc2c8ca0b095f99cef301b8bc0 Mon Sep 17 00:00:00 2001 From: ".ext" <279833035+dotext@users.noreply.github.com> Date: Sat, 19 Sep 2026 22:08:56 +1000 Subject: [PATCH 1/2] Update README and templates --- .github/ISSUE_TEMPLATE/01-bug-report.yaml | 153 +++++++++--------- .../ISSUE_TEMPLATE/02-feature-request.yaml | 21 ++- .github/ISSUE_TEMPLATE/03-question.yaml | 11 +- .github/ISSUE_TEMPLATE/config.yml | 4 +- README.md | 69 ++++---- 5 files changed, 132 insertions(+), 126 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/01-bug-report.yaml b/.github/ISSUE_TEMPLATE/01-bug-report.yaml index b1bc1b6..0f475d7 100644 --- a/.github/ISSUE_TEMPLATE/01-bug-report.yaml +++ b/.github/ISSUE_TEMPLATE/01-bug-report.yaml @@ -1,13 +1,11 @@ ---- - name: 🐞 Bug report description: If you found something that we should know about labels: [Bug] body: - type: markdown attributes: - value: | - Thanks for taking the time to fill out this bug report! + value: Thanks for taking the time to fill out this bug report! + - type: checkboxes attributes: label: Please answer the following questions for yourself before submitting an issue @@ -22,25 +20,25 @@ body: - type: input id: app_version attributes: - label: AdGuard version - description: What version of our application are you running? - placeholder: For example, 2.14.1 release + label: AdGuard Version + description: What version of AdGuard for Mac are you running? + placeholder: For example, 2.19 validations: required: true - type: input id: br_version attributes: - label: Browser version - description: What browser do you use? - placeholder: For example, Safari 17 + label: Browser Version + description: What browser do you use, and what version are you running? + placeholder: For example, Safari 27.0.1 validations: required: false - type: input id: os_version attributes: - label: OS version - description: What operating system do you use? - placeholder: For example, macOS Sonoma 14.5 + label: macOS Version + description: What version of macOS are you running? + placeholder: For example, macOS Golden Gate 27.0.1 validations: required: true @@ -53,8 +51,8 @@ body: value: | Select enabled filters if they are related to the application bug. If the issue is related to the filtering (missed ads, cookie, etc.) - use the [Web Reporting Tool](https://kb.adguard.com/technical-support/reporting-tool) please. - + please use the [Web Reporting Tool](https://link.adtidy.org/forward.html?action=report&app=home&from=github). + - type: dropdown id: filters_adblock attributes: @@ -74,6 +72,7 @@ body: multiple: true options: - AdGuard Tracking Protection filter + - AdGuard Mail Tracking Protection filter - AdGuard URL Tracking filter - EasyPrivacy - Legitimate URL Shortener @@ -99,7 +98,6 @@ body: label: Annoyances multiple: true options: - - AdGuard Annoyances filter - AdGuard Cookie Notices filter - AdGuard Popups filter - AdGuard Mobile App Banners filter @@ -107,8 +105,10 @@ body: - AdGuard Widgets filter - Adblock Warning Removal List - Fanboy's Annoyances + - Web Annoyances Ultralist - EasyList Cookie List - Dandelion Sprout's Annoyances List + - Steveo's AI Blocklist validations: required: false @@ -122,7 +122,7 @@ body: - Phishing URL Blocklist - Scam Blocklist by DurableNapkin - uBlock Origin – Badware risks - - NoCoin Filter List + - Dandelion Sprout's Anti-Malware List validations: required: false @@ -133,7 +133,6 @@ body: multiple: true options: - Filter unblocking search ads and self-promotion - - AdGuard DNS filter - AdGuard Experimental filter - Fanboy's Anti-thirdparty Fonts validations: @@ -145,23 +144,19 @@ body: label: Language-specific multiple: true options: - - AdGuard Chinese filter - - AdGuard Dutch filter - - AdGuard French filter + - AdGuard Russian filter - AdGuard German filter - AdGuard Japanese filter - - AdGuard Russian filter + - AdGuard Dutch filter - AdGuard Spanish/Portuguese filter - AdGuard Turkish filter + - AdGuard French filter - AdGuard Ukrainian filter + - AdGuard Italian filter + - AdGuard Polish filter + - AdGuard Chinese filter - ABPindo - - ABPVN List - - Adblock List for Finland - - AdBlockID - Bulgarian list - - CJX's Annoyances List - - Dandelion Sprout's Nordic Filters - - Dandelion Sprout's Serbo-Croatian List - EasyList China - EasyList Czech and Slovak - EasyList Dutch @@ -169,43 +164,50 @@ body: - EasyList Hebrew - EasyList Italy - EasyList Lithuania - - EasyList Polish - - EasyList Portuguese - - EasyList Spanish - - EasyList Thailand - - Estonian List - - Frellwit's Swedish Filter - - Greek AdBlock Filter - - Hungarian filter - - Icelandic ABP List - - IndianList - - KAD - Anti-Scam - Latvian List - - List-KR - Liste AR - Liste FR - - Macedonian adBlock Filters + - ROList + - Icelandic ABP List + - AdBlockID + - Greek AdBlock Filter + - EasyList Portuguese + - EasyList Thailand + - Hungarian filter + - Xfiles + - "RU AdList: Counters" + - ABPVN List - Official Polish filters for AdBlock, uBlock Origin & AdGuard - - Persian Blocker - - Polish Annoyances Filters - - Polish Anti Adblock Filters - - Polish Anti-Annoying Special Supplement - Polish GDPR-Cookies Filters + - Estonian List + - CJX's Annoyances List - Polish Social Filters - - road-block light - - ROList - - ROLIST2 - - RU AdList - Counters - - Xfiles + - filterslist-KO Classic filter list - xinggsf + - EasyList Spanish + - KAD - Anti-Scam + - Adblock List for Finland + - ROLIST2 + - Persian Blocker + - road-block + - Polish Annoyances Filters + - Polish Anti Adblock Filters + - Frellwit's Swedish Filter - YousList + - EasyList Polish + - Polish Anti-Annoying Special Supplement + - Dandelion Sprout's Serbo-Croatian List + - IndianList + - Macedonian adBlock Filters + - Dandelion Sprout's Nordic Filters validations: required: false - + - type: dropdown id: dns_protection attributes: - label: Which DNS server do you use? + description: Which DNS server do you use? If you don't use DNS protection, select 'DNS protection disabled'. + label: DNS Server multiple: false options: - DNS protection disabled @@ -223,29 +225,32 @@ body: - Custom DNS validations: required: true - + - type: dropdown id: dns_protocol attributes: - label: DNS protocol + description: What DNS protocol do you use? If you don't use DNS protection, select 'DNS protection disabled'. + label: DNS Protocol multiple: false options: + - DNS protection disabled - Regular - DNSCrypt - DNS-over-HTTPS - DNS-over-TLS - DNS-over-QUIC validations: - required: false - + required: true + - type: textarea id: custom_dns attributes: label: Custom DNS - description: Please provide a link to the custom DNS you use - placeholder: If you have enabled DNS from the pre-defined list, skip this + description: Please provide a link to the custom DNS you use. + placeholder: If you have selected a DNS server from the pre-defined list, skip this. validations: required: false + - type: dropdown id: stealth attributes: @@ -264,7 +269,6 @@ body: - Block WebRTC - Block Push API - Block Location API - - Block Java - Hide your Referrer from third-parties - Hide your User Agent - Mask your IP address @@ -274,12 +278,12 @@ body: - type: input id: customer_id attributes: - label: Support ticket ID + label: Support Ticket ID description: If you've already sent us a diagnostic report through the application, share the ticket ID number. You can find it in an auto-reply email from AdGuard support after sending a report. placeholder: Enter a ticket ID validations: required: false - + - type: textarea id: what-happened attributes: @@ -288,12 +292,12 @@ body: placeholder: value: | Steps to reproduce: - 1. - 2. - 3. + 1. + 2. + 3. validations: required: true - + - type: textarea id: how_it_should_be attributes: @@ -301,7 +305,7 @@ body: placeholder: A clear and concise description of what you expected to happen. validations: required: false - + - type: textarea id: how_it_is attributes: @@ -309,25 +313,26 @@ body: placeholder: A clear description of what happened instead. validations: required: true - + - type: textarea id: screens attributes: label: Screenshots description: | - If applicable add screenshots explaining your problem. + If applicable, add screenshots explaining your problem. You can drag and drop images or paste them from clipboard. Use `
` tag to hide screenshots under the spoiler. - placeholder: If applicable add screenshots explaining your problem. + placeholder: If applicable, add screenshots explaining your problem. value: |
Screenshot 1 - - - + + + +
validations: required: false - + - type: textarea id: additional attributes: @@ -340,4 +345,4 @@ body: attributes: value: | --- - Upvote [important issues](https://github.com/AdguardTeam/AdguardForMac/issues?q=is%3Aissue+is%3Aopen+sort%3Areactions-%2B1-desc+) with a :+1: \ No newline at end of file + Upvote [important issues](https://github.com/AdguardTeam/AdguardForMac/issues?q=is%3Aissue+is%3Aopen+sort%3Areactions-%2B1-desc+) with a :+1: diff --git a/.github/ISSUE_TEMPLATE/02-feature-request.yaml b/.github/ISSUE_TEMPLATE/02-feature-request.yaml index 06a8d16..9e29c92 100644 --- a/.github/ISSUE_TEMPLATE/02-feature-request.yaml +++ b/.github/ISSUE_TEMPLATE/02-feature-request.yaml @@ -1,9 +1,11 @@ ---- - name: 🌱 Feature request -description: Create a feature request to help us improve AdGuard for Mac. +description: If you know how AdGuard for Mac can be improved labels: ['Feature request'] body: + - type: markdown + attributes: + value: Thanks for taking the time to fill out this form! + - type: textarea id: what-happened attributes: @@ -11,25 +13,28 @@ body: description: What happened? placeholder: Is your feature request related to a problem? Please add a clear and concise description of what the problem is. validations: - required: false + required: true + - type: textarea id: how_it_should_be attributes: - label: Proposed solution + label: Proposed Solution description: placeholder: Describe the solution you'd like in a clear and concise manner. validations: - required: false + required: true + - type: textarea id: additional attributes: - label: Alternative solution + label: Alternative Solution description: placeholder: A clear and concise description of any alternative solutions or features you've considered. validations: required: false + - type: markdown attributes: value: | --- - Upvote [important issues](https://github.com/AdguardTeam/AdguardForMac/issues?q=is%3Aissue+is%3Aopen+sort%3Areactions-%2B1-desc+) with a :+1: \ No newline at end of file + Upvote [important issues](https://github.com/AdguardTeam/AdguardForMac/issues?q=is%3Aissue+is%3Aopen+sort%3Areactions-%2B1-desc+) with a :+1: diff --git a/.github/ISSUE_TEMPLATE/03-question.yaml b/.github/ISSUE_TEMPLATE/03-question.yaml index 43fab86..821d9b2 100644 --- a/.github/ISSUE_TEMPLATE/03-question.yaml +++ b/.github/ISSUE_TEMPLATE/03-question.yaml @@ -1,23 +1,26 @@ name: ❓ Question description: If the options above do not work for you -labels: ["Question"] +labels: "Question" body: - type: markdown attributes: value: Thanks for taking the time to fill out this form! - + - type: checkboxes attributes: label: Please answer the following questions for yourself before submitting a question. options: - label: I am running the latest version + required: true + - label: I checked the [knowledge base](https://adguard.com/kb/) and found no answer + required: true - label: I checked to make sure that this issue has not already been filed required: true - + - type: textarea id: question attributes: label: Ask a question placeholder: If you want to know more about how the app works. validations: - required: true \ No newline at end of file + required: true diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml index 0d494fc..caaa8c2 100644 --- a/.github/ISSUE_TEMPLATE/config.yml +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -7,6 +7,6 @@ 'name': 'AdGuard filters issues' 'url': 'https://link.adtidy.org/forward.html?action=report&app=home&from=github' - 'about': > - Please check AdGuard Knowledgebase for more useful information about our products - 'name': 'Knowledgebase' + Please check the AdGuard Knowledge Base for more useful information about our products + 'name': 'Knowledge Base' 'url': 'https://adguard.com/kb/' diff --git a/README.md b/README.md index 46af83f..2a08a06 100644 --- a/README.md +++ b/README.md @@ -10,36 +10,16 @@

- Website | + Website | Reddit | - Twitter | + X | Telegram

- - - Latest release - - - Beta version> - - - -* [Contribution](#contribution) - * [How to report an issue](#issue) - * [Translating AdGuard](#contribution-translating) - * [Other options](#contribution-other) - * [How to become a Beta tester](#beta-tester) -* [Our plans](#our-plans) - -> ### Disclaimer ->* AdGuard for Mac is not an open source project. We use GitHub as an open bug tracker for users to see what developers are working on. However, we at AdGuard create [a lot of open source software](https://github.com/search?o=desc&q=topic%3Aopen-source+org%3AAdguardTeam+fork%3Atrue&s=stars&type=Repositories). ->* Privacy policy: https://adguard.com/privacy/mac.html (Briefly: AdGuard sends only necessary, limited information, e.g. information required for a license check). - -AdGuard is the only standalone ad blocker app for Mac that can block ads equally well in all browsers and apps, not only in Safari. It will also protect your data from tracking and shield your privacy. - -To get more information and to download AdGuard for Mac, visit our website [https://adguard.com/](https://adguard.com/adguard-mac/overview.html). - + Latest release + Beta version +

+
+

@@ -48,34 +28,47 @@ To get more information and to download AdGuard for Mac, visit our website [http +

+
+ +AdGuard is the only standalone ad blocker app for Mac that can block ads equally well in all browsers and apps, not only in Safari. It will also protect your data from tracking and shield your privacy. + +To get more information and to download AdGuard for Mac, [visit our website](https://adguard.com/adguard-mac/overview.html). + +> ### Disclaimer +>* AdGuard for Mac is not an open source project. We use GitHub as an open bug tracker for users to see what developers are working on. However, we at AdGuard create [a lot of open source software](https://github.com/search?o=desc&q=topic%3Aopen-source+org%3AAdguardTeam+fork%3Atrue&s=stars&type=Repositories). +>* View our [Privacy Policy](https://adguard.com/privacy/mac.html) (Briefly: AdGuard sends only necessary, limited information, e.g. information required for a license check). +
+ +* [Contribution](#contribution) + * [How to report an issue](#issue) + * [Translating AdGuard](#contribution-translating) + * [Other options](#contribution-other) + * [How to become a Beta tester](#beta-tester) + +
## Contribution -### How to report an issue? +### How to report an issue GitHub can be used to report a bug or to submit a feature request. To do so, go to [this page](https://github.com/AdguardTeam/AdguardForMac/issues) and click the *New issue* button. ->**Note:** for the filter-related issues (missed ads, false positives etc.) use our [reporting tool](https://kb.adguard.com/technical-support/reporting-tool#mac). +>**Note:** for the filter-related issues (missed ads, false positives etc.) use our [reporting tool](https://link.adtidy.org/forward.html?action=report&app=home&from=github). ### Translating AdGuard -If you want to help with AdGuard translations, please learn more about translating our products here: https://kb.adguard.com/en/general/adguard-translations +If you want to help with AdGuard translations, please learn more about translating our products [here](https://adguard.com/kb/miscellaneous/contribute/translate/program/). ### Other options Here is a [dedicated page](https://adguard.com/contribute.html) for those who are willing to contribute. - -### How to become a beta tester? - -You can submit an application to participate in AdGuard for Mac beta-testing program. All necessary information on this topic can be found on the [dedicated page](https://adguard.com/beta.html). - - -## Our plans +### How to become a beta tester -To see the "big picture", to watch current progress and to get an idea of approximate dates for upcoming AdGuard for Mac releases, see this page: https://github.com/AdguardTeam/AdGuardforMac/milestones +You can submit an application to participate in the AdGuard for Mac beta-testing program. All necessary information on this topic can be found on the [dedicated page](https://adguard.com/beta.html?platform=mac). From f80e53bfc661fd085af30ec0e9cabf250e662b2f Mon Sep 17 00:00:00 2001 From: ".ext" Date: Thu, 8 Oct 2026 03:28:08 +1100 Subject: [PATCH 2/2] Fix typo Fixes typo of what should be Stevo's AI Blocklist Co-authored-by: Iaroslav Khvorostenko --- .github/ISSUE_TEMPLATE/01-bug-report.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/ISSUE_TEMPLATE/01-bug-report.yaml b/.github/ISSUE_TEMPLATE/01-bug-report.yaml index 0f475d7..35a7c2c 100644 --- a/.github/ISSUE_TEMPLATE/01-bug-report.yaml +++ b/.github/ISSUE_TEMPLATE/01-bug-report.yaml @@ -108,7 +108,7 @@ body: - Web Annoyances Ultralist - EasyList Cookie List - Dandelion Sprout's Annoyances List - - Steveo's AI Blocklist + - Stevo's AI Blocklist validations: required: false