diff --git a/docs/adguard-browser-extension/overview.md b/docs/adguard-browser-extension/overview.md index 20fb5660516..eea6b5f2008 100644 --- a/docs/adguard-browser-extension/overview.md +++ b/docs/adguard-browser-extension/overview.md @@ -15,7 +15,7 @@ AdGuard provides a range of software products that block ads and trackers on dif ## Availability {#br-extension} -[AdGuard Browser Extension](https://adguard.com/en/adguard-browser-extension/overview.html) is available for most major browsers. You can easily find it in your browser’s online store or on our official website. +[AdGuard Browser Extension](https://adguard.com/adguard-browser-extension/overview.html) is available for most major browsers. You can easily find it in your browser’s online store or on our official website. ![Available for most popular browsers *border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_availability.png) diff --git a/docs/adguard-for-android/installation.md b/docs/adguard-for-android/installation.md index 8cc967df589..4d63ef9f4e3 100644 --- a/docs/adguard-for-android/installation.md +++ b/docs/adguard-for-android/installation.md @@ -41,7 +41,7 @@ A popup will appear. Tap *Settings*, navigate to *Install unknown apps*, and gra This guide is for Android 8+. If you have an older OS version, before downloading the apk file, go to *Settings* and select *Additional settings* in *System & Device*. Enable *Unknown sources* and tap *OK* in the system warning window. -3. **Install the app**. Once the browser has obtained the necessary permissions, the system will ask you if you want to install the AdGuard application. Tap *Install*. +3. **Install the app**. Once the browser has obtained the necessary permissions, the system will ask you if you want to install the AdGuard app. Tap *Install*. ![Installing apps from unknown sources *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/android/installation/inst_4.png) diff --git a/docs/adguard-for-android/overview.md b/docs/adguard-for-android/overview.md index c3e2c190334..c6c8a10c5ae 100644 --- a/docs/adguard-for-android/overview.md +++ b/docs/adguard-for-android/overview.md @@ -49,7 +49,7 @@ Use the Import feature to transfer your rules to a different device. Nowadays almost all websites work via HTTPS, the web protocol where the last S letter stands for "secure". It happened so that most advertisers use this protocol as well, this is why [HTTPS filtering](/general/https-filtering/what-is-https-filtering) is really crucial for a modern ad blocker. -![What is https](https://cdn.adtidy.org/public/Adguard/Blog/https/what_is_https.png) +![What is HTTPS](https://cdn.adtidy.org/public/Adguard/Blog/https/what_is_https.png) To be able to filter HTTPS traffic, AdGuard needs to install a certificate into your device's user storage. On older versions of Android OS this was done automatically during the onboarding process or later via AdGuard settings, and it only required a couple of taps. On Android 11 and later automatic certificate installation is no longer available. Now you need to install the certificate manually. @@ -174,7 +174,7 @@ The simplicity of this approach is both a benefit and a disadvantage. The main a ## DNS servers -But AdGuard for Android "DNS package" does not end just there. One of the useful perks is an option to select *absolutely any* DNS server to use. At your service is a list consisting of dozens of servers to choose from, from our own AdGuard DNS servers to other popular providers like Google DNS, Cloudflare and others. On top of that, if your favorite server is not in the default list, you still can enter its address manually and use it anyway. See the comprehensive list of popular DNS providers — you can find many DNS servers there and any to AdGuard with a tap of a finger. +But AdGuard for Android "DNS package" does not end just there. One of the useful perks is an option to select *absolutely any* DNS server to use. At your service is a list consisting of dozens of servers to choose from, from our own AdGuard DNS servers to other popular providers like Google DNS, Cloudflare and others. On top of that, if your favorite server is not in the default list, you still can enter its address manually and use it anyway. See the comprehensive list of popular DNS providers — you can find many DNS servers there and add any to AdGuard with a tap of a finger. There are several reasons to use a custom DNS server instead of one offered by your ISP by default. Some servers are faster, some provide ad blocking or parental control solutions, some enhance your privacy etc. @@ -237,13 +237,13 @@ The best kind of compatibility is when you install two apps and they just start ![Compatibility *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/android/features/compatibility.png) -Both apps will detect each other and do everything that's needed for smooth joint work. All that will be left for you is to enjoy both ad-free Internet and the benefits of a VPN. It also works the other way around just as well: install AdGuard Ad Blocker on top of an already-running AdGuard VPN and you're good. +Both apps will detect each other and do everything that's needed for smooth joint work. All that will be left for you is to enjoy both ad-free Internet and the benefits of a VPN. It also works the other way around just as well: install AdGuard Ad Blocker on top of an already-running AdGuard VPN and you're good to go. If you'd like to disable Compatibility Mode for any reason, it's very simple to do so from AdGuard Ad Blocker settings, just toggle the switch. Additionally, you can add AdGuard Ad Blocker and AdGuard VPN tiles to your device's notification bar and toggle them in one tap at your own will — thanks to Compatibility Mode the configuration will change immediately and silently. ## License -While some ot the features in AdGuard for Android are free, others require [purchasing a license](https://adguard.com/en/license.html). There are Personal (up to three devices) and Family (up to 9 devices), Yearly and Lifetime license keys. The premium version offers the following features to its users: +While some ot the features in AdGuard for Android are free, others require [purchasing a license](https://adguard.com/license.html). There are Personal (up to three devices) and Family (up to 9 devices), Yearly and Lifetime license keys. The premium version offers the following features to its users: * Stealth Mode * Browsing security * Extensions @@ -258,6 +258,6 @@ There are too many features to describe them all in detail, so let us simply lis * When you visit certain screens for the first time, there will appear tooltips that describe the purpose of that screen and its main features * You can export or import AdGuard settings (for a faster switch between the settings profiles or to transfer your profile between different devices) -* Select an update channel, i.e. the mode in which the application receives its updates (stable release channel, less stable beta channel and raw ["nightly" channel](https://adguard.com/en/blog/nightly-builds/) +* Select an update channel, i.e. the mode in which the app receives its updates (stable release channel, less stable beta channel and raw ["nightly" channel](https://adguard.com/en/blog/nightly-builds/) * By tapping a little battery icon on the main screen of the app you will get to the "Battery Usage" screen. System battery stats [are often wrong](../solving-problems/battery), so we decided to have our own, one that would reflect the real state of things * You can change the app's language in the General Settings tab diff --git a/docs/adguard-for-android/solving-problems/background-work.md b/docs/adguard-for-android/solving-problems/background-work.md index 848edc363cb..e779e31ddaf 100644 --- a/docs/adguard-for-android/solving-problems/background-work.md +++ b/docs/adguard-for-android/solving-problems/background-work.md @@ -110,7 +110,7 @@ The following steps should be performed on any Xiaomi device that keeps killing Please enable: - **Settings** → **Advanced Settings** → **Battery manager** → set **Power plan** to **Performance** -- **Device Settings** → **Advanced Settings** → **Battery Manager** → **Protected apps** – AdGuard needs to be **Protected** +- **Device Settings** → **Advanced Settings** → **Battery Manager** → **Protected apps** — AdGuard needs to be **Protected** - **Device Settings** → **Apps** → **AdGuard** → **Battery** → **Power-intensive prompt** and **Keep running after screen off** - **Settings** → **Additional Settings** → **Battery & Performance** → **Manage apps’ battery usage** and here: @@ -310,7 +310,7 @@ If AdGuard keeps getting killed, also try running ### EMUI 6+ devices (and some EMUI 5 devices): - **Phone settings** → **Advanced Settings** → **Battery manager** → **Power plan** set to **Performance**; -- **Phone Settings** → **Advanced Settings** → **Battery Manager** → **Protected apps** – set AdGuard as **Protected**; +- **Phone Settings** → **Advanced Settings** → **Battery Manager** → **Protected apps** — set AdGuard as **Protected**; - **Phone Settings** → **Apps** → **Your app** → **Battery** → **Power-intensive prompt** `[uncheck]` and **Keep running after screen off** `[check]`; - **Phone settings** → **Apps** → **Advanced (At the bottom)** → **Ignore optimizations** → Press Allowed → **All apps** → Find AdGuard on the list and set to **Allow**. diff --git a/docs/adguard-for-android/solving-problems/battery.md b/docs/adguard-for-android/solving-problems/battery.md index eacbd34f457..2caeb9bc9f5 100644 --- a/docs/adguard-for-android/solving-problems/battery.md +++ b/docs/adguard-for-android/solving-problems/battery.md @@ -11,9 +11,9 @@ This article covers AdGuard for Android, a multifunctional ad blocker that prote On Android devices running OS 6 and earlier, built-in statistics often attributed high data and/or battery usage to AdGuard. This was because AdGuard counted all the traffic it filtered from various apps. As a result, AdGuard's share of total data and battery usage was overstated, while other apps were understated. -With OS 7, however, this scenario has improved. Now the data reflected in Android's built-in data usage statistics is very close to reality, although there are minor discrepancies in the battery usage data. +With Android 7, however, this scenario has improved. Now the data reflected in Android's built-in data usage statistics is very close to reality, although there are minor discrepancies in the battery usage data. -Nevertheless, AdGuard users can always get a true picture of the situation on the *Battery usage* screen. +However, AdGuard users can always get a true picture of the situation on the *Battery usage* screen. ### Own battery usage stats screen @@ -25,7 +25,7 @@ Inside you will find a chart that shows the AdGuard battery resource consumption ### How much battery resource does AdGuard really consume? -First, let us lay down a little bit of theory and links with necessary data. +First, let us lay down a bit of theory and links with necessary data. 1. Android derives traffic consumption judging on so-called Power Profile, which is given by every manufacturer: diff --git a/docs/adguard-for-android/solving-problems/compatibility-issues.md b/docs/adguard-for-android/solving-problems/compatibility-issues.md index ad3f76827fc..db8bb9afa5c 100644 --- a/docs/adguard-for-android/solving-problems/compatibility-issues.md +++ b/docs/adguard-for-android/solving-problems/compatibility-issues.md @@ -18,7 +18,7 @@ Other VPN apps are incompatible with AdGuard running in the Local VPN filtering :::caution -Please note that on Android 10 and later devices, the 'manual' HTTP proxy mode is no longer supported. +On Android 10 and later, the 'manual' HTTP proxy mode is no longer supported. ::: diff --git a/docs/adguard-for-android/solving-problems/samsungpay-with-adguard-in-south-korea.md b/docs/adguard-for-android/solving-problems/samsungpay-with-adguard-in-south-korea.md index 1fa3d3f2678..35aa9bc79f1 100644 --- a/docs/adguard-for-android/solving-problems/samsungpay-with-adguard-in-south-korea.md +++ b/docs/adguard-for-android/solving-problems/samsungpay-with-adguard-in-south-korea.md @@ -11,7 +11,7 @@ This article covers AdGuard for Android, a multifunctional ad blocker that prote A number of users have encountered an issue where Samsung Pay does not work while AdGuard is running. This issue occurs almost exclusively on devices registered in South Korea. -What is causing this issue? Sometimes Samsung Pay does not work on devices with VPN services running, and AdGuard is one of these applications. By default, AdGuard uses Local VPN to filter traffic. As a result, users had to disable AdGuard when making payments with Samsung Pay. This can now be avoided with the new **Detect Samsung Pay** feature. When this option is enabled, the AdGuard app is paused whenever the user opens the Samsung Pay app and resumes when the app is closed. +What is causing this issue? Sometimes Samsung Pay does not work on devices with VPN services running, and AdGuard is one of these apps. By default, AdGuard uses Local VPN to filter traffic. As a consequence, users had to disable AdGuard when making payments with Samsung Pay. This can now be avoided with the new **Detect Samsung Pay** feature. When this option is enabled, the AdGuard app is paused whenever the user opens the Samsung Pay app and resumes when the app is closed. To enable **Detect Samsung Pay**, follow these steps: diff --git a/docs/adguard-for-ios/overview.md b/docs/adguard-for-ios/overview.md index 9136059d468..d65d5452535 100644 --- a/docs/adguard-for-ios/overview.md +++ b/docs/adguard-for-ios/overview.md @@ -91,7 +91,7 @@ In addition, at the bottom of the screen there is an option to add a custom DNS ![Network settings screen *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/network_settings_en.jpeg) -Users can also handle their DNS security on the Network settings screen. *Filter mobile data* and *Filter Wi-Fi* enable or disable DNS protection for the respective network types. Further down, at *Wi-Fi exceptions*, you can exclude particular Wi-Fi networks from DNS protection (for example, you might want to exclude your home network if you use [AdGuard Home](https://adguard.com/en/adguard-home/overview.html)). +Users can also handle their DNS security on the Network settings screen. *Filter mobile data* and *Filter Wi-Fi* enable or disable DNS protection for the respective network types. Further down, at *Wi-Fi exceptions*, you can exclude particular Wi-Fi networks from DNS protection (for example, you might want to exclude your home network if you use [AdGuard Home](https://adguard.com/adguard-home/overview.html)). ### DNS filtering {#dns-filtering} @@ -181,7 +181,7 @@ For the most part, the settings in this section are best left untouched: only us ### Block IPv6 {#blockipv6} -For any DNS query sent to get an IPv6 address, our app returns an empty response (as if this IPv6 address does not exist). Now there is an option not to return IPv6 addresses. At this point the description of this function becomes too technical: configuring or disabling IPv6 is the exclusive domain of advanced users. Presumably, if you are one of them, it will be good to know that we now have this feature, if not – there is no need to dive into it. +For any DNS query sent to get an IPv6 address, our app returns an empty response (as if this IPv6 address does not exist). Now there is an option not to return IPv6 addresses. At this point the description of this function becomes too technical: configuring or disabling IPv6 is the exclusive domain of advanced users. Presumably, if you are one of them, it will be good to know that we now have this feature, if not — there is no need to dive into it. ### Bootstrap and Fallback servers {#bootstrap-fallback} diff --git a/docs/adguard-for-ios/web-extension.md b/docs/adguard-for-ios/web-extension.md index df237dc35d5..8ac4a83e0ff 100644 --- a/docs/adguard-for-ios/web-extension.md +++ b/docs/adguard-for-ios/web-extension.md @@ -33,7 +33,7 @@ You will see the following list of options: ### In the iOS settings -Web extension is not a standalone tool and requires AdGuard for iOS. If you don't have AdGuard for iOS installed on your device, please [install it first](../installation) and complete the onboarding process to prepare it for work. +The Web extension is not a standalone tool and requires AdGuard for iOS. If you don't have AdGuard for iOS installed on your device, please [install it first](../installation) and complete the onboarding process to prepare it for work. Once done, open *Settings → Safari → Extensions*. diff --git a/docs/adguard-for-mac/browser-assistant.md b/docs/adguard-for-mac/browser-assistant.md index 1882e2b0fb3..0af1cee368c 100644 --- a/docs/adguard-for-mac/browser-assistant.md +++ b/docs/adguard-for-mac/browser-assistant.md @@ -33,8 +33,8 @@ On rare occasions, a browser may prove incompatible with the Browser Assistant, ::: -## Separate tab in settings -The new Browser Assistant has its own tab in AdGuard for Mac settings, together with Stealth Mode, Browsing Security, Parental Control and others. Don’t worry if you missed the opportunity to install Browser Assistant during the onboarding, you'll find this option in the app's settings. Besides, there is a checkbox to enable the legacy Assistant. +## Separate tab in Settings +The new Browser Assistant has its own tab in the AdGuard for Mac settings, together with Stealth Mode, Browsing Security, Parental Control and others. Don’t worry if you missed the opportunity to install Browser Assistant during the onboarding, you'll find this option in the app's settings. Besides, there is a checkbox to enable the legacy Assistant. ![Browser Assistant tab](https://cdn.adtidy.org/content/kb/ad_blocker/mac/assistant-separate-tab.png) @@ -46,4 +46,4 @@ Technically, you won’t need to do it on your own: during the onboarding proces AdGuard Browser Assistant is available for all popular browsers: Chrome, Firefox, Safari, Edge, Opera, and Yandex. To install the Browser Assistant for your default browser, you can do it directly from the app settings, but you also have an opportunity to install it for other browsers. -To install the one you need (or many, it is not prohibited but even encouraged), go to [our website](https://adguard.com/en/adguard-assistant/overview.html), click the browser icon and then the *Install* button. That’s it! +To install the one you need (or many, it is not prohibited but even encouraged), go to [our website](https://adguard.com/adguard-assistant/overview.html), click the browser icon and then the *Install* button. That’s it! diff --git a/docs/adguard-for-mac/installation.md b/docs/adguard-for-mac/installation.md index 9c7914ef75d..5e674fbb541 100644 --- a/docs/adguard-for-mac/installation.md +++ b/docs/adguard-for-mac/installation.md @@ -21,7 +21,7 @@ This article covers AdGuard for Mac, a multifunctional ad blocker that protects ## Installation -To install AdGuard for macOS on your computer, launch your browser, type _adguard.com_ in the address bar, and press **Download** [on the page that opens](https://adguard.com/download.html?auto=1). +To install AdGuard for Mac on your computer, launch your browser, type _adguard.com_ in the address bar, and press **Download** [on the page that opens](https://adguard.com/download.html?auto=1). ![Download the app *border](https://cdn.adtidy.org/content/kb/ad_blocker/mac/1.jpg) @@ -45,7 +45,7 @@ Wait for the installer to download the required files. ![Wait until the necessary files are downloaded](https://cdn.adtidy.org/content/kb/ad_blocker/mac/6.jpg) -To use the application, you will need the administrator password for your macOS account. Enter the password when propped in the dialogue box and press **OK**. +To use the application, you will need the administrator password for your macOS account. Enter the password when prompted in the dialogue box and press **OK**. ![Enter the password](https://cdn.adtidy.org/content/kb/ad_blocker/mac/7.jpg) diff --git a/docs/adguard-for-mac/overview.md b/docs/adguard-for-mac/overview.md index 4a57bab4e8f..a07cf453408 100644 --- a/docs/adguard-for-mac/overview.md +++ b/docs/adguard-for-mac/overview.md @@ -107,7 +107,7 @@ AdGuard Browser Assistant’s primary function is to manage filtering directly f ![Assistant popup menu *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/mac/safari_assistant_pop-up_menu.jpg) -You will be prompted to install the Browser Assistant for your default browser when you first install AdGuard (during the onboarding process). If you missed it, you can [download it for any browser](https://adguard.com/en/adguard-assistant/overview.html) at any time. +You will be prompted to install the Browser Assistant for your default browser when you first install AdGuard (during the onboarding process). If you missed it, you can [download it for any browser](https://adguard.com/adguard-assistant/overview.html) at any time. ## Extensions diff --git a/docs/adguard-for-safari/installation.md b/docs/adguard-for-safari/installation.md index 82b09e1f6db..182f78bf252 100644 --- a/docs/adguard-for-safari/installation.md +++ b/docs/adguard-for-safari/installation.md @@ -25,7 +25,7 @@ AdGuard for Safari is a free app presented on the App Store. To install it on yo :::note -Not all extensions are required for AdGuard for Safari to function correctly. For instance, checking the *Icon* extension enables the icon in the tray menu. However, we recommend to enable all of them. +Not all extensions are required for AdGuard for Safari to function correctly. For instance, checking the *Icon* extension enables the icon in the tray menu. However, we recommend enabling all of them. ::: @@ -44,7 +44,7 @@ To uninstall AdGuard for Safari, do the following: ![Extensions checked](https://cdn.adtidy.org/public/Adguard/kb/installation/Safari/extensionschecked.png) -At this point you will see a notification: +At this point, you will see a notification: ![Notification: uninstall AdGuard for Safari](https://cdn.adtidy.org/public/Adguard/kb/installation/Safari/showinfinder.png) diff --git a/docs/adguard-for-safari/overview.md b/docs/adguard-for-safari/overview.md index 17b47ef895f..68bb7fd4c0d 100644 --- a/docs/adguard-for-safari/overview.md +++ b/docs/adguard-for-safari/overview.md @@ -9,7 +9,7 @@ This article is about AdGuard for Safari, which safeguards only your Safari brow ::: -AdGuard for Safari was designed to conform to Apple's restrictions for ad blocking browser extensions and is the most popupar ad blocker for Safari. Although it can’t be compared to our desktop ad blocking apps, it's free and can protect you from ads, trackers, phishing, and malicious websites. +AdGuard for Safari was designed to conform to Apple's restrictions for ad blocking browser extensions and is the most popular ad blocker for Safari. Although it can’t be compared to our desktop ad blocking apps, it's free and can protect you from ads, trackers, phishing, and malicious websites. ## General {#general} diff --git a/docs/adguard-for-windows/browser-assistant.md b/docs/adguard-for-windows/browser-assistant.md index fe07854ae8d..37eadb3a3d5 100644 --- a/docs/adguard-for-windows/browser-assistant.md +++ b/docs/adguard-for-windows/browser-assistant.md @@ -25,7 +25,7 @@ The extension and the app worked in conjunction but sometimes the integration wo When using the Browser Assistant, all these problems don’t matter as there can be no conflicts in essence. The role of the Browser Assistant is well-defined and it can’t hinder the functioning of the main app, so there is no need to worry. -## Separate tab in settings +## Separate tab in Settings The new Browser Assistant has its own tab in AdGuard for Windows settings, along with Stealth Mode, Browsing Security, Parental Control and others. There you will find a link to download the extension for your default browser. Besides, there is a checkbox to enable the legacy Assistant. @@ -39,4 +39,4 @@ Legacy Assistant is the previous version of Assistant, which is a mere userscrip If you want to install the Browser Assistant for your default browser, you can do it directly from the app settings, but you also have an opportunity to install it for other browsers. -AdGuard Browser Assistant is available for all popular browsers: Chrome, Firefox, Edge, Opera, and Yandex. To install the one you need (or many, it is not prohibited but even encouraged), go to [our website](https://adguard.com/en/adguard-assistant/overview.html), click the browser icon and tap the *Install* button. That’s it! +AdGuard Browser Assistant is available for all popular browsers: Chrome, Firefox, Edge, Opera, and Yandex. To install the one you need (or many, it is not prohibited but even encouraged), go to [our website](https://adguard.com/adguard-assistant/overview.html), click the browser icon and tap the *Install* button. That’s it! diff --git a/docs/adguard-for-windows/overview.md b/docs/adguard-for-windows/overview.md index ad751869318..b9e688fa8f1 100644 --- a/docs/adguard-for-windows/overview.md +++ b/docs/adguard-for-windows/overview.md @@ -123,7 +123,7 @@ AdGuard Extra is essentially a mini-program that changes the way pages work,and **AdGuard Popup Blocker** -This extension prevents popup windows from opening when you view web pages. Some pop-ups are considered useful – they may contain settings for site administering or additional reference information demonstrated upon clicking a link. That is why you can turn off the Blocker if needed. This extension doesn’t work on websites added to the AdGuard exceptions list either. It is turned off by default, but you can turn it on in the application settings. You will find more detailed information about this extension in our Knowledge base. +This extension prevents popup windows from opening when you view web pages. Some pop-ups are considered useful — they may contain settings for site administering or additional reference information demonstrated upon clicking a link. That is why you can turn off the Blocker if needed. This extension doesn’t work on websites added to the AdGuard exceptions list either. It is turned off by default, but you can turn it on in the application settings. You will find more detailed information about this extension in our Knowledge base. **Web of Trust** diff --git a/docs/general/ad-filtering/create-own-filters.md b/docs/general/ad-filtering/create-own-filters.md index cd3a7326745..af596908c1f 100644 --- a/docs/general/ad-filtering/create-own-filters.md +++ b/docs/general/ad-filtering/create-own-filters.md @@ -30,7 +30,7 @@ Any line that starts with an exclamation mark is a comment. In the list of rules For example: ``` -! This is the comment. Under this line there is an actual filtering rule. +! This is the comment. Below this line, there is an actual filtering rule. ||example.org^ ``` @@ -71,7 +71,7 @@ Filtering rules support numerous modifiers that allow you to fine-tune the rule **This rule blocks:** -* `http://example.org/script.js` if this script is loaded from `example.com`. +* `http://example.org/script.js` if this script is loaded from `example.org`. **This rule does not block:** @@ -88,9 +88,9 @@ Filtering rules support numerous modifiers that allow you to fine-tune the rule Blocking rules with [`$important`](#important-modifier) modifier can override exceptions. -### Unblocking everything on a website +### Unblocking an entire website -![Unblocking everything](https://cdn.adtidy.org/content/kb/ad_blocker/general/4_unblock_entire_website.svg) +![Unblocking an entire website](https://cdn.adtidy.org/content/kb/ad_blocker/general/4_unblock_entire_website.svg) **This rule unblocks** @@ -133,7 +133,7 @@ It is not to be confused with the fully functional AdGuard for Android that can [our website](https://adguard.com/adguard-android/overview.html). Unfortunately, AdGuard Content Blocker capabilities are limited by what the browsers allow and they only support an old Adblock Plus filters syntax: -* Basic blocking rules with the following modifiers: `$domain`, `$third-party`, [content type modifiers](#content-type-modifiers). +* Basic blocking rules with the following modifiers: `$domain`, `$third-party`, [content-type modifiers](#content-type-modifiers). * Basic exception rules with the following modifiers: `$document`, `$elemhide`. * Basic [element hiding rules](#cosmetic-elemhide-rules) with no extended CSS support. @@ -229,7 +229,7 @@ Rules with wildcard for TLD are not supported by AdGuard Content Blocker. ### Basic rules modifiers * [Basic modifiers](#basic-rules-basic-modifiers) -* [Content type modifiers](#content-type-modifiers) +* [Content-type modifiers](#content-type-modifiers) * [Exception modifiers](#exception-modifiers) :::note @@ -436,7 +436,7 @@ where: * **`string`** — a sequence of characters. It is matched against the header value lexicographically; * **`regexp`** — a regular expression, starts and ends with `/`. The pattern works the same way as in the basic URL rules, but the characters `/`, `$` and `,` must be escaped with `\`. -The modifier `":" h_value` part may be omitted. In that case the modifier matches the header name only. +The modifier `":" h_value` part may be omitted. In that case, the modifier matches the header name only. **Examples** @@ -490,9 +490,13 @@ This modifier limits the rule scope to requests that use the specified set of HT * `@@||evil.com$method=get` unblocks only GET requests to `evil.com`. * `@@||evil.com$method=~post` unblocks any requests to `evil.com` except POST. -Please note that rules with mixed value restriction are considered invalid. So, for example, the rule +:::note + +Rules with mixed value restriction are considered invalid. So, for example, the rule `||evil.com^$method=get|~head` will be rejected. +::: + :::info Compatibility Rules with the `$method` are supported by AdGuard for Windows, Mac, Android, **running CoreLibs v1.12 or later**, and AdGuard Browser extension for Chrome, Firefox, Edge, **running TSUrlFilter v2.1.1 or later**. @@ -565,7 +569,7 @@ Rules with the `$to` modifier are supported by AdGuard for Windows, Mac, and And ::: -### Content type modifiers {#content-type-modifiers} +### Content-type modifiers {#content-type-modifiers} [//]: # (Please keep them sorted) @@ -592,7 +596,7 @@ There is a big difference in how AdGuard determines the content type on differen ::: -**Content type modifiers examples** +**Examples of content-type modifiers** * `||example.org^$image` — corresponds to all images from `example.org`. * `||example.org^$script,stylesheet` — corresponds to all the scripts and styles from `example.org`. @@ -1203,8 +1207,7 @@ preroll.ts :::caution Restrictions * `$hls` rules are only allowed [**in trusted filters**](#trusted-filters). -* `$hls` rules are not compatible with any other modifiers - except `$domain`, `$third-party`, `$app`, `$important`, `$match-case`, and `$xmlhttprequest`. +* `$hls` rules are compatible with the modifiers `$domain`, `$third-party`, `$app`, `$important`, `$match-case`, and `$xmlhttprequest` only. * `$hls` rules only apply to HLS playlists, which are UTF-8 encoded text starting with the line `#EXTM3U`. Any other response will not be modified by these rules. * `$hls` rules do not apply if the size of the original response is more than 3 MB. @@ -1456,8 +1459,7 @@ In AdGuard for Windows, Mac and Android **running CoreLibs v1.11 or later**, JSO :::caution Restrictions -* `$jsonprune` rules are not compatible with any other modifiers - except `$domain`, `$third-party`, `$app`, `$important`, `$match-case`, and `$xmlhttprequest`. +* `$jsonprune` rules are only compatible with these specific modifiers: `$domain`, `$third-party`, `$app`, `$important`, `$match-case`, and `$xmlhttprequest`. * `$jsonprune` rules do not apply if the size of the original response is more than 3 MB. ::: @@ -1623,7 +1625,7 @@ If a request matches multiple `$referrerpolicy` rules not disabled by exceptions :::caution Restrictions `$referrerpolicy` rules are compatible only with -`$document` and `$subdocument` [content type modifiers](#content-type-modifiers). +`$document` and `$subdocument` [content-type modifiers](#content-type-modifiers). ::: @@ -1850,7 +1852,7 @@ With these rules, specified UTM parameters will be removed from any request save :::caution Restrictions * Rules with `$removeparam` modifier can be used [**only in trusted filters**](#trusted-filters). -* `$removeparam` rules are compatible with [basic modifiers](#basic-rules-common-modifiers), [content type modifiers](#content-type-modifiers), and with `$important` and `$app` modifiers. The rules which have any other modifiers are considered invalid and will be discarded. +* `$removeparam` rules are compatible with [basic modifiers](#basic-rules-common-modifiers), [content-type modifiers](#content-type-modifiers), and with `$important` and `$app` modifiers. The rules which have any other modifiers are considered invalid and will be discarded. ::: diff --git a/docs/general/ad-filtering/filter-policy.md b/docs/general/ad-filtering/filter-policy.md index 9e690829345..6f180fd29c9 100644 --- a/docs/general/ad-filtering/filter-policy.md +++ b/docs/general/ad-filtering/filter-policy.md @@ -3,7 +3,7 @@ title: AdGuard filter policy sidebar_position: 6 --- -When discussing AdGuard ad filters, one topic often comes up – whether AdGuard should block this or that ad. By setting the rules, we stick to specific criteria that are very similar to [EasyList Policy](https://easylist.to/pages/policy.html), which we find correct and appropriate. However, we have made some changes to it. +When discussing AdGuard ad filters, one topic often comes up — whether AdGuard should block this or that ad. By setting the rules, we stick to specific criteria that are very similar to [EasyList Policy](https://easylist.to/pages/policy.html), which we find correct and appropriate. However, we have made some changes to it. ![To filter or not to filter](https://cdn.adtidy.org/public/Adguard/Common/page_filtering.png) diff --git a/docs/general/ad-filtering/how-ad-blocking-works.md b/docs/general/ad-filtering/how-ad-blocking-works.md index 15975d221b4..98d7542d22e 100644 --- a/docs/general/ad-filtering/how-ad-blocking-works.md +++ b/docs/general/ad-filtering/how-ad-blocking-works.md @@ -21,7 +21,7 @@ Filter lists, also called filters, lie at the core of any ad blocker. Filters ar To better understand ad blocking, it's important to know the underlying principles of how filters work. -Filtering rules that make up filters are not created automatically. They are developed by filter maintainers, including professionals and volunteers, who use browser developer consoles and other tools (such as the AdGuard's filtering log) to determine which rules will block a particular ad or tracker. This description of the process is very simplistic – some ads are particularly hard to block and require multiple rules, multiple iterations, and the use of complex syntax. +Filtering rules that make up filters are not created automatically. They are developed by filter maintainers, including professionals and volunteers, who use browser developer consoles and other tools (such as the AdGuard's filtering log) to determine which rules will block a particular ad or tracker. This description of the process is very simplistic — some ads are particularly hard to block and require multiple rules, multiple iterations, and the use of complex syntax. And even when a rule finally gets added to a filter, it doesn't mean that it stays there forever. Ads change, ways to serve the same ads on the same websites change, and the filter rules have to change, too. Sometimes rules become obsolete, a new ad appears, or a new filtering rule is needed to block the same ad. Filters are often maintained by one person, but even for a team of maintainers, it's impossible to constantly monitor the entire web. That's why many ad blockers have tools to help users easily report any filter-related issues they encounter. diff --git a/docs/general/ad-filtering/search-ads.md b/docs/general/ad-filtering/search-ads.md index a2079153f92..c437f951dd2 100644 --- a/docs/general/ad-filtering/search-ads.md +++ b/docs/general/ad-filtering/search-ads.md @@ -5,7 +5,7 @@ sidebar_position: 3 **Disclosure.** While AdGuard provides an option to show some ads, we do not have any 'acceptable ads' program like Adblock Plus and some other ad blockers, where they take money for leaving certain ads unblocked. This is not our case. We do not get paid for showing any of the ads, and we do not use the term 'acceptable' for a reason: the ads we might show may be, in fact, useful and not just 'acceptable'. All of this applies only to search ads and self-promotion ads. -To be absolutely clear, this is **completely optional**. You can turn off the display of these ads at any time with no penalty whatsoever. Furthermore, we will explain which ads qualify for this definition. +You can turn off the display of these ads at any time. Furthermore, we will explain which ads qualify for this definition. ### Search ads diff --git a/docs/general/ad-filtering/tracking-filter-statistics.md b/docs/general/ad-filtering/tracking-filter-statistics.md index c560197d1a9..44fbebbb5db 100644 --- a/docs/general/ad-filtering/tracking-filter-statistics.md +++ b/docs/general/ad-filtering/tracking-filter-statistics.md @@ -5,7 +5,7 @@ sidebar_position: 4 :::note -The *"Send statistics for ad filters usage"* option is disabled by default. Nothing will be sent unless user manually enables it to help us improve our blocking filters. +The *Send statistics for ad filters usage* option is disabled by default. Nothing will be sent unless a user manually enables it to help us improve our blocking filters. ::: @@ -37,7 +37,7 @@ The list is created based on the website's visit statistics since the last time The collected statistics will be sent periodically to our server for analysis and filter optimization. -It's important to note that all the statistics we get are averaged and anonymized. We don't use these statistics for any purpose other than optimizing the filters, and we do not sell this data to third parties. You can read about our Privacy Policy [here](https://adguard.com/en/privacy.html). +It's important to note that all the statistics we get are averaged and anonymized. We don't use these statistics for any purpose other than optimizing the filters, and we do not sell this data to third parties. You can read about our Privacy Policy [here](https://adguard.com/privacy.html). ### What does tracking filter rules statistics fraught with? diff --git a/docs/general/https-filtering/what-is-https-filtering.md b/docs/general/https-filtering/what-is-https-filtering.md index 288f7a8beb7..fa48c7ac2be 100644 --- a/docs/general/https-filtering/what-is-https-filtering.md +++ b/docs/general/https-filtering/what-is-https-filtering.md @@ -55,7 +55,7 @@ A [2017 study](https://cdn.adtidy.org/public/Adguard/Blog/https/interception-nds The researchers came to a simple conclusion: the Internet security community should pay close attention to applications that filter secure connections. And the developers of such software must pay serious attention to the quality of filtering implementations. -We would like to note that AdGuard was not tested in the above study. We ran estimates according to their set of tests, and at the time of testing, we could have received the maximum score – A\*. However, this score is not perfect. During the study, the researchers identified some issues that were omitted in the final evaluation. +We would like to note that AdGuard was not tested in the above study. We ran estimates according to their set of tests, and at the time of testing, we could have received the maximum score — A\*. However, this score is not perfect. During the study, the researchers identified some issues that were omitted in the final evaluation. Here at AdGuard, we fully agree with those conclusions. Moreover, we would like to be as open with users as possible and talk about the problems we are currently experiencing and the steps we are taking to improve the quality and security of the filtering mechanism. The list of these problems is sorted by priority. diff --git a/docs/general/license/activation.md b/docs/general/license/activation.md index 63bfc8eb6fe..0ff886c1306 100644 --- a/docs/general/license/activation.md +++ b/docs/general/license/activation.md @@ -97,7 +97,7 @@ or double-click the AdGuard icon in the system tray: 3. Tap **Log in** in the top right corner of the screen -![Tap Log in in the top right corner of Premium screen *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/iOS/ioslicense1en.png) +![Tap Log in in the top right corner of the Premium screen *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/iOS/ioslicense1en.png) 4. Enter **email** and **password** from your **AdGuard account** diff --git a/docs/general/license/what-is.md b/docs/general/license/what-is.md index 87bcce3e508..104bf0f74fb 100644 --- a/docs/general/license/what-is.md +++ b/docs/general/license/what-is.md @@ -1,9 +1,9 @@ --- -title: What is AdGuard license +title: What is an AdGuard license sidebar_position: 1 --- -## What is AdGuard license +## What is an AdGuard license A license is permission to use the AdGuard product, provided in accordance with the End User License Agreement. AdGuard licenses exist in the form of license keys, activation codes, and product cards in the user's [AdGuard account](../../account/register). diff --git a/docs/guides/collect-har-file.md b/docs/guides/collect-har-file.md index 6afc0d7aabe..f11cdce44b4 100644 --- a/docs/guides/collect-har-file.md +++ b/docs/guides/collect-har-file.md @@ -26,7 +26,7 @@ To create a HAR file in Chrome: 7. Check the ***Disable cache*** check box. -![chrome](https://cdn.adtidy.org/content/Kb/ad_blocker/guides/chrome.png) +![Chrome](https://cdn.adtidy.org/content/Kb/ad_blocker/guides/chrome.png) 8. Reproduce the steps that create the issue. @@ -139,7 +139,7 @@ To create a HAR file in Safari: ## Android {#android} -To get HAR files follow these steps: +To create HAR files, follow these steps: 1. Open AdGuard and go to ***Settings***. diff --git a/docs/guides/report-website.md b/docs/guides/report-website.md index d165e257821..0de16aad603 100644 --- a/docs/guides/report-website.md +++ b/docs/guides/report-website.md @@ -74,7 +74,7 @@ To report a reinsertion of an ad or incorrect displaying of a website, you need :::note -When you send a complaint via the app or via AdGuard Assistant, all information is pre-filled automatically. Except for the screenshots, you'll have to make and attach them yourself. If you're using a [direct link](https://reports.adguard.com/en/new_issue.html), you’ll need to enter data manually. +When you send a complaint via the app or via AdGuard Assistant, all information is pre-filled automatically. Except for the screenshots, you'll have to make and attach them yourself. If you're using a [direct link](https://reports.adguard.com/new_issue.html), you’ll need to enter data manually. ::: diff --git a/docs/miscellaneous/contribute/translate/become-translator.md b/docs/miscellaneous/contribute/translate/become-translator.md index 31fb709b9ed..5cc72b61a94 100644 --- a/docs/miscellaneous/contribute/translate/become-translator.md +++ b/docs/miscellaneous/contribute/translate/become-translator.md @@ -35,7 +35,7 @@ Besides, there is an opportunity to open translations in a Voting mode if you ju ![crowdin *border](https://cdn.adtidy.org/public/Adguard/kb/en/ag-translations/mode.png) -You can find some [helpful tips on translating AdGuard in this article](../guidelines). Please have a look at it. +You can find some [helpful tips on translating AdGuard in this article](../guidelines). Please take a look at it. ### How to become a proofreader {#proofreaders} @@ -51,4 +51,4 @@ So, what are proofreaders responsible for? - Respond to comments related to translations in their language. -Every year best proofreaders receive gifts from AdGuard. Active translators do not go unrewarded either. Read more about our [reward system](../rewards). +Every year, the best proofreaders receive gifts from AdGuard. Active translators do not go unrewarded either. Read more about our [reward system](../rewards). diff --git a/docs/miscellaneous/contribute/translate/plural-forms.md b/docs/miscellaneous/contribute/translate/plural-forms.md index 7f0081732fb..3067493ac2e 100644 --- a/docs/miscellaneous/contribute/translate/plural-forms.md +++ b/docs/miscellaneous/contribute/translate/plural-forms.md @@ -12,11 +12,11 @@ We strongly recommend you to properly read this article to learn more about plur Nouns in different languages can have several plural word forms. Their usage depends on the number of things you are talking about. -For instance, English words have two word forms when speaking about something in the singular, like *'one star'*, and in the plural – *'two stars'*. It doesn’t matter if you say five, twenty six or even five hundred thirty two stars – the ending 's' will remain the same. But some languages can contain only one or many plural forms. +For instance, English words have two word forms when speaking about something in the singular, like *'one star'*, and in the plural — *'two stars'*. It doesn’t matter if you say five, twenty six or even five hundred thirty two stars — the ending 's' will remain the same. But some languages can contain only one or many plural forms. -In contrast to English, the Polish language has three plural forms of nouns. One of them is used when speaking about something in the singular, another form is used in the plural but with numbers ending in 2-4, excluding 12-14, and the third form – for words with other numbers in front of them. +In contrast to English, the Polish language has three plural forms of nouns. One of them is used when speaking about something in the singular, another form is used in the plural but with numbers ending in 2-4, excluding 12-14, and the third form — for words with other numbers in front of them. -Let’s have a look at this picture. Here you can see the groups of numerals which determine a word form when standing in front of it. +Let’s take a look at this picture. Here you can see the groups of numerals which determine a word form when standing in front of it. ![Polish](https://cdn.adtidy.org/content/Kb/ad_blocker/miscellaneous/adguard_translations/polish.png) @@ -94,7 +94,7 @@ Please be attentive when translating these strings and approving them. If you ha This is the most complicated type of AdGuard strings which is mostly used in `AdGuard Websites` project. -Pay close attention to a vertical bar sign between the sentences and **%count%** placeholders in original phrases – this will help you identify phrases where translations require the use of plural forms. +Pay close attention to a vertical bar sign between the sentences and **%count%** placeholders in original phrases — this will help you identify phrases where translations require the use of plural forms. ![crowdin *border](https://cdn.adtidy.org/public/Adguard/kb/en/plurals/plurals_site.png) @@ -108,9 +108,9 @@ Coming back to the example, as the English language includes only two forms, the `Standard license for *%count%* computer | Standard license for *%count%* computers` -where **template 1** – Standard license for *%count%* computer, +where **template 1** is Standard license for *%count%* computer, -and **template 2** – Standard license for *%count%* computers +and **template 2** is Standard license for *%count%* computers Another important thing you should pay your attention to is **%count%** placeholders that, as usual, take place before the words they define. Instead of **%count%** here will appear different numbers depending on which templates are being chosen. @@ -148,7 +148,7 @@ And again: if you come across an original phrase with two important elements: ** + Refer to the plural rule of a language you translate into; -The number of your templates should be consistent with the number of plural forms your language includes, even in cases some words have fewer forms themselves. Two plural forms – two templates in translations; five plural forms – five templates, etc. +The number of your templates should be consistent with the number of plural forms your language includes, even in cases some words have fewer forms themselves. Two plural forms — two templates in translations; five plural forms — five templates, etc. + Do not forget to use a vertical bar sign between templates as it is represented in original strings;