Merge branch 'adguard-cli' of https://github.com/AdguardTeam/Knowledg…

…eBase into adguard-cli

docs/general/ad-filtering/create-own-filters.md

@@ -453,7 +453,7 @@ despite the pattern `||*page` may match specific domains.
 
 :::caution Limitations
 
-In [AdGuard for Chrome MV3][ext-mv3] `regexp` and `any_tld domains` are not supported.
+In [AdGuard for Chrome MV3][ext-mv3], `regexp` and `any_tld_domain` entries are not supported.
 
 :::
 

docs/general/ad-filtering/how-ad-blocking-works.md

@@ -31,7 +31,7 @@ And even when a rule finally gets added to a filter, it doesn't mean that it sta
 
 AdGuard users [have access to a special web reporting tool](https://reports.adguard.com/new_issue.html). Thanks to user complaints, filter developers can focus on correcting their filter lists and not on scouring the Internet for new and old unblocked ads.
 
-Filters can do more than just block ads. There are filters that block tracking, social media widgets, and annoyances such as cookie notices. Different users may choose different combinations of filters to match their personal preferences. There are websites like [filterlists.com](https://filterlists.com/) that are dedicated to filter lists and have huge databases.
+Filters can do more than just block ads. There are filters that block tracking, social media widgets, and annoyances, such as cookie notices. Different users may choose different combinations of filters to match their personal preferences. There are websites like [filterlists.com](https://filterlists.com/) that are dedicated to filter lists and have huge databases.
 
 We develop and maintain [our own set of filter lists](../adguard-filters) that can be used with AdGuard or other ad blockers.
 
@@ -62,3 +62,41 @@ These rules are quite complicated and require the ad blocker to be granted certa
 There are other types of filtering rules, but they require more advanced technical knowledge to understand how they work. If you are interested, [check out our comprehensive guide on filtering rules in the linked article](../create-own-filters).
 
 :::
+
+## Types of request handling in AdGuard
+
+AdGuard handles requests according to filters, user rules and settings enabled by the user. As a result, a request can be blocked, modified, allowed or, when nothing is done to it, just processed.
+
+Detailed information on how each request of yours has been handled by AdGuard can be found in the *Filtering log* (AdGuard for Windows, AdGuard for Mac, AdGuard Browser Extension) or *Recent activity* (AdGuard for iOS, AdGuard for Android).
+
+Regarding AdGuard filters, you can also check [our filter policy](../filter-policy), which describes in detail what and why each of our filters blocks.
+
+### Examples of blocked requests
+
+AdGuard DNS filter blocks requests to ad domains, such as `ad.doubleclick.net`.
+
+AdGuard Tracking Protection filter blocks tracking requests, such as `youtube.com/youtubei/log_event?`.
+
+### Examples of allowed requests
+
+AdGuard Base filter allows non-ad requests, such as `www.google.com/complete/search?q=`.
+
+Filter unblocking search ads and self-promotion allows requests to search ad-related domains, such as `www.google.com/aclk?`.
+
+Requests to websites that are added by the user to *Allowlist* are allowed.
+
+### Examples of modified requests
+
+Tracking protection feature with protection level set to *High* enables AdGuard URL Tracking filter which modifies requests by removing tracking parameters from them:
+
+`https://www.rentio.jp/products/ax-n1b?click_from=top_newitems` → `https://www.rentio.jp/products/ax-n1b`
+
+`https://www.baseballchannel.jp/npb/183688/?ref=ise` → `https://www.baseballchannel.jp/npb/183688/`
+
+`https://www.gog.com/game/spec_ops_the_line?pp=2863d7ae605104eeef364e3f164d3404e20f680c&gad_source=1` →
+`https://www.gog.com/game/spec_ops_the_line`
+
+Please note that *modified* events you see in the Filtering log or Recent activity refer not only to the cases when a request is modified, but also when:
+
+- something on the page is changed (usually by cosmetic rules)
+- the response is modified

docs/general/stealth-mode.md

@@ -1,9 +1,9 @@
 ---
-title: Stealth Mode
+title: Stealth Mode (Tracking protection)
 sidebar_position: 4
 ---
 
-Many websites gather information about their visitors, such as their IP address, installed browser and operating system, screen resolution, and even the page from which a visitor was redirected. Some web pages use cookies to mark your browser and save your personal settings and preferences, or to "recognize" you upon your next visit. Stealth Mode safeguards your personal information from such data- and statistics-gathering systems.
+Many websites gather information about their visitors, such as their IP address, installed browser and operating system, screen resolution, and even the page from which a visitor was redirected. Some web pages use cookies to mark your browser and save your personal settings and preferences, or to "recognize" you upon your next visit. *Stealth Mode* (or *Tracking protection* in AdGuard for Windows and AdGuard Browser Extension) safeguards your personal information from such data- and statistics-gathering systems.
 
 You can flexibly adjust the work of Stealth Mode: for instance, you can prohibit the website from receiving the search request you used to find it on the Internet, automatically delete both third-party and the website's own cookies, turn off browser geolocation sharing that can be used to track your whereabouts, and hide your true IP address or even replace it with an arbitrary one.
 
@@ -17,21 +17,21 @@ Some options may not be available depending on the particular product due to OS
 
 ## General {#general}
 
-### Hide your search queries {#searchqueries}
+### Hide search queries {#searchqueries}
 
 When you get directed to a website from Google, Yahoo, or any other search engine, this option hides the search query that you used to find that website.
 
-### Ask websites not to track you {#donottrack}
+### Send signals to opt out of tracking {#donottrack}
 
 Sends the [Global Privacy Control](https://globalprivacycontrol.org/#gpc-spec) and [Do Not Track](https://en.wikipedia.org/wiki/Do_Not_Track) signals to the websites you visit.
 
-### Strip tracking parameters from URLs
+### Remove tracking parameters from URLs {#removetracking}
 
 If you enable this option, AdGuard will strip tracking parameters like `utm_*` and `fb_ref` from pages’ URLs.
 
 ### Tracking methods {#tracking-methods}
 
-### Self-destruction of third-party cookies {#3p-cookie}
+### Delete third-party cookies {#3p-cookie}
 
 Websites use cookies to store your information and preferences, such as the language you selected, your location, or the list of items in your shopping cart. When you return to a website, your browser sends back the cookies belonging to that website, which allows it to "remember" your data.
 
@@ -45,7 +45,7 @@ This setting deletes all third-party cookies, including the information of your
 
 :::
 
-### Self-destruction of first-party cookies {#1p-cookie}
+### Delete first-party cookies (not recommended) {#1p-cookie}
 
 Set a time period (in minutes) at the end of which all cookies will be destroyed. Set the timer to 0 to block them completely.
 
@@ -55,7 +55,7 @@ We do not recommend enabling this option as it may severely interfere with the w
 
 :::
 
-### Disable cache for third-party requests {#3p-cache}
+### Block ETag and If-None-Match headers {#3p-cache}
 
 When a browser addresses a page, the server assigns an ETag to that page. This ETag is used by the browser to cache the page's contents. Upon subsequent requests, the browser sends the ETag to the corresponding server, thus letting the server learn the visitor’s identity. As long as the site's files are cached, the ETag is sent every time your browser addresses this site. If the site has embedded content from another server (such as an image or iframe), that server can track your activities without your knowledge.
 
@@ -98,23 +98,23 @@ Note that to be able to filter traffic, AdGuard applications 'intercept' browser
 
 On the other hand, due to the nature of all browser extensions, AdGuard Browser Extension works 'inside' the browser. It will alter the Referer right then and there, so Developer Tools will show the desired Referer for your requests.
 
-### Hide your User-Agent {#useragent}
+### Hide User-Agent {#useragent}
 
 When you visit a website, your browser sends its information to the server. It looks like a text line that is part of an HTTP request that begins with "User-Agent:". It usually includes the name and version of the browser, the operating system, and language settings. We cut User-Agent from identifying information so that advertisers cannot obtain it.
 
 You can also set an arbitrary value for User-Agent by entering it into the Custom User-Agent field. To use default User-Agent, leave the field blank.
 
-### Hide your IP address {#ip}
+### Mask IP address {#ip}
 
 Stealth Mode cannot hide your IP address. However, we can conceal it so that websites you visit will think you are a proxy. Sometimes this helps, and websites ignore your true IP address.
 
 You can set an arbitrary IP address, which you would like others to perceive as yours, by simply entering it into the corresponding field. To use the default IP address, leave the field blank.
 
-### Remove X-Client-Data header from HTTP requests {#xclientdata}
+### Remove X-Client-Data header {#xclientdata}
 
 It forbids Google Chrome from sending its version and modification information with requests to Google domains (including Double Click and Google Analytics).
 
-### Protect from DPI {#dpi}
+### Protect against DPI {#dpi}
 
 The Deep Packet Inspection is a system of deep analysis and filtering of traffic by packet content, as well as the accumulation of statistical data. Using this technology, ISPs have the ability to control the passing traffic and limit access to content for their clients.
 

i18n/be/docusaurus-plugin-content-docs/current/adguard-browser-extension/adguard-browser-extension.md

@@ -13,25 +13,25 @@ This article is about AdGuard Browser Extension, which safeguards only your brow
 
 Here are outlined the main features and settings available in the AdGuard Browser Extension.
 
-[Features](/adguard-browser-extension/features/features.md)
+[Features](/adguard-browser-extension/features)
 
 ## Availability
 
 In this article, you'll learn about the supported browsers and platforms where the extension can be installed.
 
-[Availability](/adguard-browser-extension/availability.md)
+[Availability](/adguard-browser-extension/availability)
 
 ## Installation
 
 The article explains how to install the AdGuard Browser Extension on various supported browsers.
 
-[Installation](/adguard-browser-extension/installation.md)
+[Installation](/adguard-browser-extension/installation)
 
 ## Compatibility with the standalone app
 
 The article explains the compatibility of the AdGuard Browser Extension with the AdGuard desktop apps.
 
-[Compatibility with the standalone app](adguard-browser-extension/compatibility.md)
+[Compatibility with the standalone app](/adguard-browser-extension/compatibility)
 
 ## AdGuard Browser Extension for Chrome MV3
 
@@ -43,16 +43,16 @@ This article discusses the AdGuard browser extension for Chrome, which is compat
 
 The article describes how the AdGuard Browser Extension manages protected pages, restricting ad blocking on certain sensitive websites to ensure proper functionality.
 
-[Browser-protected pages](/adguard-browser-extension/protected-pages.md)
+[Browser-protected pages](/adguard-browser-extension/protected-pages)
 
 ## Solving problems
 
 This section includes guides addressing known issues and possible solutions.
 
-[Solving problems](/adguard-browser-extension/solving-problems/solving-problems.md)
+[Solving problems](/adguard-browser-extension/solving-problems)
 
 ## Comparison to standalone apps
 
 The article highlights the differences in functionality, coverage, and features between the AdGuard extensions and desktop apps.
 
-[Comparison to standalone apps](/adguard-browser-extension/comparison-standalone.md)
+[Comparison to standalone apps](/adguard-browser-extension/comparison-standalone)

i18n/be/docusaurus-plugin-content-docs/current/adguard-browser-extension/availability.md

@@ -23,4 +23,4 @@ We have a standalone extension for Safari. Since the release of [Safari 13](http
 
 :::
 
-**Do not forget that the functionality of each extension is strictly limited by the browser’s capabilities.** So if you want to get full-fledged protection, consider installing a standalone program for your computer. There's [a reason why](adguard-browser-extension/comparison-standalone).
+**Do not forget that the functionality of each extension is strictly limited by the browser’s capabilities.** So if you want to get full-fledged protection, consider installing a standalone program for your computer. There's [a reason why](/adguard-browser-extension/comparison-standalone).

i18n/be/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/high-sierra-compatibility.md

@@ -9,8 +9,12 @@ This article is about AdGuard for Mac, a multifunctional ad blocker that protect
 
 :::
 
-During the installation of AdGuard on macOS High Sierra (or later), you may see this message: "System Extension Blocked". This is a new security mechanism that appeared in High Sierra, it requires you to explicitly allow the installation of a third-party system extension. To complete the installation of AdGuard you have to manually allow loading the extension in *System Preferences* → *Security & Privacy* → *General*.
+During the installation of AdGuard on macOS High Sierra (or later), you may receive the message "System Extension Blocked". This is a new security mechanism introduced in High Sierra that requires you to explicitly allow the installation of a third-party system extension.
+
+To complete the installation of AdGuard you have to manually allow loading the extension by clicking the "Allow" button in *System Preferences* → *Security & Privacy* → *General*.
+
+On macOS Sequoia, you can do it in *System Preferences* → *Security & Privacy* → *General* → *Login Items & Extensions*. Once there, click the "i" icon next to *Network Extensions* and toggle the AdGuard option.
 
 ![Allow extension installation in settings](https://cdn.adtidy.org/public/Adguard/kb/PicturesEN/highsierra.png)
 
-Click the "Allow" button, and after that you will be able to proceed with the installation as normal.
+After that you will be able to proceed with the installation as usual.

i18n/be/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md

@@ -49,7 +49,7 @@ User rules and allowlist rules are included into every extension.
 
 ## AdGuard for Safari
 
-*AdGuard for Safari activates the AdGuard icon next to the search bar. It's useful if you want to quickly set up protection for a specific website or block ads manually. It also contains advanced rules that aren't converted to the format supported by Safari. These include [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [Extended CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets), which allow AdGuard to block complex ads, such as those on YouTube.
+*AdGuard for Safari* activates the AdGuard icon next to the search bar. It's useful if you want to quickly set up protection for a specific website or block ads manually. It also contains advanced rules that aren't converted to the format supported by Safari. These include [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [extended CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets), which allow AdGuard to block complex ads, such as those on YouTube.
 
 ## How to manage Safari extensions
 

i18n/be/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md

@@ -446,7 +446,7 @@ In the following examples it is implied that requests are sent from `http://exam
 
 :::caution Limitations
 
-In [AdGuard for Chrome MV3][ext-mv3] `regexp` and `any_tld domains` are not supported.
+In [AdGuard for Chrome MV3][ext-mv3], `regexp` and `any_tld_domain` entries are not supported.
 
 :::
 

i18n/be/docusaurus-plugin-content-docs/current/general/ad-filtering/how-ad-blocking-works.md

@@ -31,7 +31,7 @@ And even when a rule finally gets added to a filter, it doesn't mean that it sta
 
 AdGuard users [have access to a special web reporting tool](https://reports.adguard.com/new_issue.html). Thanks to user complaints, filter developers can focus on correcting their filter lists and not on scouring the Internet for new and old unblocked ads.
 
-Filters can do more than just block ads. There are filters that block tracking, social media widgets, and annoyances such as cookie notices. Different users may choose different combinations of filters to match their personal preferences. There are websites like [filterlists.com](https://filterlists.com/) that are dedicated to filter lists and have huge databases.
+Filters can do more than just block ads. There are filters that block tracking, social media widgets, and annoyances, such as cookie notices. Different users may choose different combinations of filters to match their personal preferences. There are websites like [filterlists.com](https://filterlists.com/) that are dedicated to filter lists and have huge databases.
 
 We develop and maintain [our own set of filter lists](../adguard-filters) that can be used with AdGuard or other ad blockers.
 
@@ -62,3 +62,40 @@ These rules are quite complicated and require the ad blocker to be granted certa
 There are other types of filtering rules, but they require more advanced technical knowledge to understand how they work. If you are interested, [check out our comprehensive guide on filtering rules in the linked article](../create-own-filters).
 
 :::
+
+## Types of request handling in AdGuard
+
+AdGuard handles requests according to filters, user rules and settings enabled by the user. As a result, a request can be blocked, modified, allowed or, when nothing is done to it, just processed.
+
+Detailed information on how each request of yours has been handled by AdGuard can be found in the *Filtering log* (AdGuard for Windows, AdGuard for Mac, AdGuard Browser Extension) or *Recent activity* (AdGuard for iOS, AdGuard for Android).
+
+Regarding AdGuard filters, you can also check [our filter policy](../filter-policy), which describes in detail what and why each of our filters blocks.
+
+### Examples of blocked requests
+
+AdGuard DNS filter blocks requests to ad domains, such as `ad.doubleclick.net`.
+
+AdGuard Tracking Protection filter blocks tracking requests, such as `youtube.com/youtubei/log_event?`.
+
+### Examples of allowed requests
+
+AdGuard Base filter allows non-ad requests, such as `www.google.com/complete/search?q=`.
+
+Filter unblocking search ads and self-promotion allows requests to search ad-related domains, such as `www.google.com/aclk?`.
+
+Requests to websites that are added by the user to *Allowlist* are allowed.
+
+### Examples of modified requests
+
+Tracking protection feature with protection level set to *High* enables AdGuard URL Tracking filter which modifies requests by removing tracking parameters from them:
+
+`https://www.rentio.jp/products/ax-n1b?click_from=top_newitems` → `https://www.rentio.jp/products/ax-n1b`
+
+`https://www.baseballchannel.jp/npb/183688/?ref=ise` → `https://www.baseballchannel.jp/npb/183688/`
+
+`https://www.gog.com/game/spec_ops_the_line?pp=2863d7ae605104eeef364e3f164d3404e20f680c&gad_source=1` → `https://www.gog.com/game/spec_ops_the_line`
+
+Please note that *modified* events you see in the Filtering log or Recent activity refer not only to the cases when a request is modified, but also when:
+
+- something on the page is changed (usually by cosmetic rules)
+- the response is modified

i18n/be/docusaurus-plugin-content-docs/current/general/browsing-security.md

@@ -19,7 +19,7 @@ Each time you visit a website, your local client exchanges information with our
 
 AdGuard provides the best possible protection by inspecting both the pages and all objects loaded on them. AdGuard checks URLs and domain names using hash prefixes, not the full URLs, so our servers retain no information about the websites you visit and your personal information is completely safe. Our servers respond to the app’s query with a list of all possible addresses that match the hash prefix. When a potential threat is detected based on hash matches, access to that website is immediately blocked.
 
-![DNS warning](https://cdn.adtidy.org/content/kb/ad_blocker/general/bs_diana.png)
+![AdGuard warning](https://cdn.adtidy.org/content/kb/ad_blocker/general/dangerous_website_blocked.png)
 
 ### In browser extensions