Merge pull request #865 from AdguardTeam/master

Master to release

01.general/02.how-to-create-your-own-ad-filters/docs.en.md

@@ -233,7 +233,7 @@ Cosmetic rules are based on using a special language named CSS, which every brow
 | ID selector | `#banners`   | Matches all elements with `id` attribute equal to `banners`.<br/>![](https://cdn.adguard.com/public/Adguard/kb/en/rules_syntax/css_id_selector.png) |
 | Class selector | `.banners`   | Matches all elements with `class` attribute containing `banners`.<br/>![](https://cdn.adguard.com/public/Adguard/kb/en/rules_syntax/css_class_selector.png) |
 | Attribute selector | `div[class="banners"]`   | Matches all `div` elements with `class` attribute **exactly equal** to `banners`.<br/>![](https://cdn.adguard.com/public/Adguard/kb/en/rules_syntax/css_class_attr.png) |
-| Attribute substring selector | `div[class^="advert1"]	`   | Matches all `div` elements which `class` attribute **starts with** the `advert1` string.<br/>![](https://cdn.adguard.com/public/Adguard/kb/en/rules_syntax/css_class_attr_start.png) |
+| Attribute substring selector | `div[class^="advert1"]`   | Matches all `div` elements which `class` attribute **starts with** the `advert1` string.<br/>![](https://cdn.adguard.com/public/Adguard/kb/en/rules_syntax/css_class_attr_start.png) |
 | Attribute substring selector | `div[class$="banners_ads"]`   | Matches all `div` elements which `class` attribute **ends with** the `banners_ads` string.<br/>![](https://cdn.adguard.com/public/Adguard/kb/en/rules_syntax/css_class_attr_end.png) |
 | Attribute substring selector | `a[href^="http://example.com/"]`   | Matches all links that are loaded from `http://example.com/` domain.<br/>![](https://cdn.adguard.com/public/Adguard/kb/en/rules_syntax/css_attr_start.png) |
 | Attribute selector | `a[href="http://example.com/"]`   | Matches all links to **exactly** the `http://example.com/` address.<br/>![](https://cdn.adguard.com/public/Adguard/kb/en/rules_syntax/css_attr_equal.png) |
@@ -301,7 +301,7 @@ For the basic rules the described logic will be applicable only for the domains
 
 * `||example.com/ads/*` — a simple rule, which corresponds to addresses like `http://example.com/ads/banner.jpg` and even `http://subdomain.example.com/ads/otherbanner.jpg`.
 
-* `||example.org^$third-party` —  a rule that blocks third-party requests to` example.org` and it's subdomains.
+* `||example.org^$third-party` —  a rule that blocks third-party requests to `example.org` and it's subdomains.
 
 * `@@||example.com$document` — general exception rule. It completely disables filtering for `example.com` and all subdomains. There is a number of modifiers which can be used in exception rules. For more details, please follow the link [below](#exceptions-modifiers).
 
@@ -346,7 +346,7 @@ If you want the rule not to be applied to certain domains, start a domain name w
 
 A restriction of third-party and own requests. A third-party request is a request from different domain. For example, a request to `example.org`, from `domain.com` is a third-party request. 
 
-> **Subdomains.** Please note that request from domain to it's subdomain (or vice versa) is not considered a third-party request. For example, a request to `subdomain.example.org`, sent from the domain` example.org` is not a third-party request. 
+> **Subdomains.** Please note that request from domain to it's subdomain (or vice versa) is not considered a third-party request. For example, a request to `subdomain.example.org`, sent from the domain `example.org` is not a third-party request. 
 
 If there is a `third-party` modifier, the rule is only applied to third-party request.
 
@@ -1757,7 +1757,7 @@ For example:
 ```
 $$div[tag-content="banner"][max-length="400"]
 ```
-This rule will remove all the `div` elements, whose code contains the substring` banner` and the length of which does not exceed `400` characters.
+This rule will remove all the `div` elements, whose code contains the substring `banner` and the length of which does not exceed `400` characters.
 
 <a id="min-length-attribute"></a>
 ##### `min-length`
@@ -1769,7 +1769,7 @@ For example:
 $$div[tag-content="banner"][min-length="400"]
 ```
 
-This rule will remove all the `div` elements, whose code contains the substring` banner` and the length of which exceeds `400` characters.
+This rule will remove all the `div` elements, whose code contains the substring `banner` and the length of which exceeds `400` characters.
 
 <a id="html-filtering-rules-exceptions"></a>
 #### Exceptions

01.general/02.how-to-create-your-own-ad-filters/docs.ru.md

@@ -233,7 +233,7 @@ visible: true
 | ID selector | `#banners`   | Соответствует всем элементам с атрибутом `id` равным `banners`.<br/>![](https://cdn.adguard.com/public/Adguard/kb/en/rules_syntax/css_id_selector.png) |
 | Class selector | `.banners`   | Соответствует всем элементам типа `class` содержащих `banners`.<br/>![](https://cdn.adguard.com/public/Adguard/kb/en/rules_syntax/css_class_selector.png) |
 | Attribute selector | `div[class="banners"]`   | Соответствует всем `div` элементам с `class` **равным**  `banners`.<br/>![](https://cdn.adguard.com/public/Adguard/kb/en/rules_syntax/css_class_attr.png) |
-| Attribute substring selector | `div[class^="advert1"]	`   | Соответствует всем `div` элементам класс `class` которых **начинается** с `advert1` строки.<br/>![](https://cdn.adguard.com/public/Adguard/kb/en/rules_syntax/css_class_attr_start.png) |
+| Attribute substring selector | `div[class^="advert1"]`   | Соответствует всем `div` элементам класс `class` которых **начинается** с `advert1` строки.<br/>![](https://cdn.adguard.com/public/Adguard/kb/en/rules_syntax/css_class_attr_start.png) |
 | Attribute substring selector | `div[class$="banners_ads"]`   | Соответствует всем `div` элементам `class` которых **заканчивается** на `banners_ads`.<br/>![](https://cdn.adguard.com/public/Adguard/kb/en/rules_syntax/css_class_attr_end.png) |
 | Attribute substring selector | `a[href^="http://example.com/"]`   | Соответствует всем ссылкам загруженным с `http://example.com/` <br/>![](https://cdn.adguard.com/public/Adguard/kb/en/rules_syntax/css_attr_start.png) |
 | Attribute selector | `a[href="http://example.com/"]`   | Соответствует всем ссылкам **конкретно** `http://example.com/` .<br/>![](https://cdn.adguard.com/public/Adguard/kb/en/rules_syntax/css_attr_equal.png) 
@@ -853,7 +853,7 @@ http://regexr.com/3cesk
 
 **Синтаксис `$csp`**
 
-Синтаксис занчений `$csp` похож на синтаксис заголовков Политики Безопасности Контента.
+Синтаксис значений `$csp` похож на синтаксис заголовков Политики Безопасности Контента.
 
 Значение `$csp` может быть пустым в случае правил-исключений. Смотрите примеры ниже для более подробной информации.
 
@@ -878,10 +878,10 @@ http://regexr.com/3cesk
 
 > **Несколько правил, соотвтествующих одному запросу**. В случае, когда несколько правил `$cookie` соответствуют одному запросу, мы применим каждое из них по очереди. 
 
-### синтаксис `$cookie`
+### Синтаксис `$cookie`
 Синтаксис правила зависит от того, собираемся ли мы заблокировать все cookie или удалить один cookie. Поведение правила можно изменить с помощью модификаторов `maxAge` и `sameSite`.
 
-* `||example.org^$cookie=NAME;maxAge=3600;sameSite=lax` -- каждый раз, когда AdGuard встречает cookie с именем `NAME` в запросе к` example.org`, он будет делать следующее:
+* `||example.org^$cookie=NAME;maxAge=3600;sameSite=lax` -- каждый раз, когда AdGuard встречает cookie с именем `NAME` в запросе к `example.org`, он будет делать следующее:
   
   * Установит дату истечения срока хранения на текущее время плюс `3600` секунд
   * Позволяет cookie использовать [Same-Site](https://developer.mozilla.org/en-US/docs/Web/HTTP/Cookies#SameSite_cookies) "lax" стратегию.
@@ -970,7 +970,7 @@ AdGuard использует тот же синтаксис правил фил
 * `@@||example.org^$redirect` отключит все правила `$redirect` для всех запросов, соответствующих `||example.org^`.
 * `@@||example.org^$redirect=redirectName` отключит правила с `$redirect=redirectName` для всех запросов, соответствующих `||example.org^`.
 
-##### примеры `redirect`
+##### Примеры `redirect`
 
 ```
 ||example.org/script.js$script,redirect=noopjs
@@ -1018,7 +1018,7 @@ AdGuard использует тот же синтаксис правил фил
 <a id="removeheader-modifier"></a>
 #### **`$removeheader`**
 
-Правила с модификатором `$removeheader` предназначены, чтобы убирать заголовки HTTP-запросов и ответов. Изначальная мотивация для создания этого типа правил заключалась в том, чтобы иметь возможность избавиться от заголовка `Refresh`, который часто используется для перенаправления пользователей на нежелаемую страницу. Однако, применение данного модификатора не ограничивается этим случаем.
+Правила с модификатором `$removeheader` предназначены для того, чтобы убирать заголовки HTTP-запросов и ответов. Изначальная мотивация для создания этого типа правил заключалась в том, чтобы иметь возможность избавиться от заголовка `Refresh`, который часто используется для перенаправления пользователей на нежелаемую страницу. Однако, применение данного модификатора не ограничивается этим случаем.
 
 Как и в случае с `$csp`, `$redirect`, `$removeparam` и `$cookie`, этот модификатор существует независимо, правила с ним не зависят от обычных базовых правил, то есть регулярные выражения или блокирующие правила никак на них не повлияют. По умолчанию, они работают только применительно к заголовкам ответов. Однако, вы также можете использовать модификатор `$removeheader`, чтобы убирать заголовки запросов.
 

01.general/07.how-ad-blocking-works/docs.en.md

@@ -7,73 +7,76 @@ visible: true
 ---
 
 *   [Introduction](#introduction)
-*   [Ad filtering](#filtering)
-*   [Page code filtering](#html)
-*   [Request blocking](#block)
-*   [CSS Injection and Javascript](#inject)
-*   [Post-processing of pages](#cosmetic)
-*   [Do you want to help?](#report)
+*   [General principle](#general)
+*   [Filter lists](#filter-lists)
+*   [Types of filtering rules](#types-filtering)
+    *   [Basic filtering rules](#basic)
+    *   [Cosmetic filtering rules](#cosmetic)
+    *   [HTML filtering rules](#html)
 
 <a name="introduction"></a>
 
 ## Introduction
 
-One of the main functions of AdGuard is filtering ads on websites. In this article, we will describe in details how exactly AdGuard filters online advertising.
+There are many different AdGuard ad blocker products for various platforms, each has its one unique features. But what unites them all is that they block ads and trackers. This article describes how ad blocking works from inside. 
 
-Adguard's work is based on the use of various advertising filters that define rules, based on which the program removes ads. AdGuard may use a variety of different ad filters. We create some of them ourselves (you can learn more about it on [this page](/general/adguard-ad-filters.html)), some of the filters are created by enthusiasts.
+> We don't cover DNS filtering here. It's a different way of blocking ads, with its own advantages and disadvantages. Follow this link to [learn more about DNS filtering](https://kb.adguard.com/en/general/dns-filtering).
+
+<a name="general"></a>
+
+## General principle
+
+At the core of any ad blocker lie filter lists, also called filters. Filters are literally lists of rules written in a special syntax. Ad blockers can understand this complex syntax. They interpret filtering rules and perform actions with web traffic based on what the rules tell them to do: block specific elements, alter web pages in certain ways, etc.
+
+<img src="https://cdn.adguard.com/public/Adguard/Blog/manifestv3/adblockingworks.png" style="max-width: 750px; border: 1px solid #efefef;">
+
+<a name="filter-lists"></a>
+
+## Filter lists
+
+To better understand ad blocking, it's important to know the underlying principles of how filters work.
+
+Filtering rules, which filters consist of, aren't created automatically. They are a product of filter maintainers' work, both professionals and volunteers. They use browsers' developer consoles and other tools (like AdGuard's Filtering log) to determine what rule would block a particular ad or tracker. This is a very simplified description of the process, as some ads are especially hard to block, require multiple rules, multiple iterations, and the use of complex syntax.
+
+And even when a rule finally gets added to the filter, it doesn't mean that it stays there forever. Ads change, ways to serve the same ads on the same websites change, and so filter rules have to change too. Sometimes rules get obsolete, sometimes a new ad appears, sometimes a new filtering rule is needed to block the same ad. Filters are often maintained by a single person, but even for a team of maintainers it's impossible to constantly monitor the entire web. This is why many ad blockers have tools to help users easily report any filter-related issues they encounter.
+
+<img src="https://cdn.adguard.com/public/Adguard/Blog/manifestv3/filtersupdates.png" style="max-width: 750px; border: 1px solid #efefef;">
+
+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, annoyances like cookie notices, etc. 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 a huge database.
+
+> We develop and maintain [our own set of filter lists](https://kb.adguard.com/en/general/adguard-ad-filters) that can be used with AdGuard or other ad blockers.
 
 
+<a name="types-filtering"></a>
 
-<a name="filtering"></a>
+## Types of filtering rules
 
-## Ad filtering
+There are many types of filtering rules that serve different purposes. Depending on the ad blocker you use, and especially on your OS, certain types of rules may not by supported.
 
-Ad filtering mechanism depends on what product you use. Browser extensions rely on the capabilities that browsers provide them with. AdGuard for Windows, Mac and Android works independently of your browser, using a completely different filtering algorithm. Below we describe all the stages of ad filtering that AdGuard uses.
+<a name="basic"></a>
 
+### Basic filtering rules
 
+To be displayed on a web page or in an app, the ad has to be loaded from a server first. To do so, the browser or the app needs to send a web request. The most basic way of preventing an ad from appearing on your screen is to block this request so it never reaches the server, and thus there's no reply.
 
-<a name="html"></a>
-
-#### Page code filtering
-
-Before a page is loaded into browser, AdGuard processes its code removing elements according to the ad filtering rules. Thus browser does not recognize that there were actually those elements on this page and will not try to load them.
-
-![Adguard: Page code filtering](https://images.adguard.com/public/Adguard/Common/page_filtering.png)
-
-Page code filtering technology is used **only in AdGuard for Windows, Mac or Android (if high quality filtering is enabled)**. That is because of the fact that capabilities of browser extensions are limited, and they can not change the page code before the browser processed it.
-
-
-
-<a name="block"></a>
-
-#### Request blocking
-
-Browser loads all the necessary elements on a page, defined by the page code. Based on filtering rules, AdGuard can block the load of advertising elements, such as banners ads or Flash objects.
-
-![Adguard: Blocking of queries](https://images.adguard.com/public/Adguard/Common/url_filtering.png)
-
-
-
-<a name="inject"></a>
-
-#### CSS Injection and Javascript
-
-Not all advertising can be blocked within the first two steps. For instance, there is such a kind of advertising that is embedded in the page dynamically with the help of Javascript, and does not require loading of additional items that we could block.
-
-CSS is a special language used for web pages design. Display style of elements on a web page can be set by rules. By style we mean color, font, location, and even the visibility of the element. And that is of interest to us, because we want to hide the banner from you. Javascript is also a special language that allows you to dynamically change any element on the page.
-
-
+Basically, all AdGuard ad blocker products can block web requests (according to the active filter rules). This method is very effective at stopping the ad but shows some drawbacks, the most obvious one is that whatever place the ad was taking up will be left empty or occupied by an ad leftover.
 
 <a name="cosmetic"></a>
 
-#### Post-processing of pages
+### Cosmetic filtering rules
 
-This is an approach for browser extensions only. It is necessary, because the first step of processing (page code filtering) is unavailable to them. During post-processing, the browser extension removes all the elements, loading of which was blocked, from a web page. If we didn't remove them, you would see not fully loaded elements, such as "broken" graphic.
+Every web page has a DOM ("document object model"), basically an HTML document that contains the page's structure and all its elements. Ads on the page are also elements and therefore reflected in the DOM. Ad blockers can remove parts of the DOM, and filtering rules help them understand which parts are ads and should be removed, and which shouldn't be messed with.
 
+This method allows to avoid whitespaces and ad leftovers mentioned above, but also to perform other, more complicated tasks.
 
+<a name="html"></a>
 
-<a name="report"></a>
+### HTML filtering rules
 
-## Do you want to help?
+In most cases, the aforementioned basic and cosmetic rules are enough to filter ads. But sometimes it is necessary to change the HTML code of the page itself before it is loaded. This is when you need filtering rules for HTML content. These rules allow to indicate the HTML elements to be cut out before the browser even loads the page.
 
-All ad filters are created manually, based on complaints on ads from users. You can send us a complaint via the program itself or write about it [on our Forum](http://forum.adguard.com/forumdisplay.php?51-Filter-Rules).
+This kind of rules is quite complicated and demands that the ad blocker possesses certain rights, so not all platforms support it. Such rules work only in AdGuard apps for Windows, Mac, and Android, and for AdGuard Firefox add-on.
+
+> There are more types of filtering rules, but they require even more technical knowledge to understand how they operate. If you're interested, [you can find the exhaustive guide on filtering rules in the linked article](https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters).

01.general/07.how-ad-blocking-works/docs.ru.md

@@ -1,5 +1,5 @@
 ---
-title: 'Как работает защита от рекламы'
+title: 'Как работает блокировка рекламы'
 taxonomy:
     category:
         - docs
@@ -7,72 +7,75 @@ visible: true
 ---
 
 *   [Введение](#introduction)
-*   [Удаление рекламы](#filtering)
-*   [Фильтрация кода страницы](#html)
-*   [Блокировка запросов](#block)
-*   [Инъекция CSS и Javascript](#inject)
-*   [Постобработка страницы](#cosmetic)
-*   [Хотите нам помочь?](#report)
+*   [Общие принципы](#general)
+*   [Фильтры](#filter-lists)
+*   [Типы правил фильтрации](#types-filtering)
+    *   [Базовые правила](#basic)
+    *   [Косметические правила](#cosmetic)
+    *   [HTML-правила](#html)
 
 <a name="introduction"></a>
 
 ## Введение
 
-Одной из основных функций AdGuard является блокировка рекламы на интернет-сайтах. В этой статье мы детально опишем, как именно AdGuard фильтрует рекламу.
+В семействе блокировщиков AdGuard есть много продуктов для разных платформ, у каждого из них свои уникальные особенности. Но что их объединяет — они все блокируют рекламу и трекинг. Эта статья описывает, как устроена блокировка рекламы изнутри.
 
-Работа AdGuard основана на использовании различных рекламных фильтров, задающих правила, основываясь на которых программа удаляет рекламу. AdGuard может использовать множество различных рекламных фильтров. Часть из них мы создаем самостоятельно (подоробнее о них вы можете узнать на [этой странице](http://testkb.adguard.com/ru/general/adguard-ad-filters)), часть фильтров создается энтузиастами.
+> В этой статье мы не касаемся DNS-фильтрации. Это альтернативный способ блокировать рекламу, со своими преимуществами и недостатками. Переходите по этой ссылке, чтобы [узнать больше про DNS-фильтрацию](https://kb.adguard.com/ru/general/dns-filtering).
 
+<a name="general"></a>
 
-<a name="filtering"></a>
+## Общие принципы
 
-## Удаление рекламы
+В основе любого блокировщика лежат фильтры. Фильтры — это буквально списки правил, написанные в соответствии с определённым синтаксисом. Блокировщики понимают этот сложный синтаксис. Они интерпретируют правила и на их основе совершают те или иные действия с веб-трафиком: блокируют элементы, изменяют вид веб-страниц и т.д.
 
-Механизм удаления рекламы зависит от того, какой продукт вы используете. Браузерные расширения полагаются на те возможности, которые предоставляют им сами браузеры. AdGuard для Windows, macOS или Android работает независимо от вашего браузера, на основе совершенно другого алгоритма фильтрации. Ниже мы опишем все этапы фильтрации рекламы, которые использует AdGuard.
+<img src="https://cdn.adguard.com/public/Adguard/Blog/manifestv3/adblockingworks_ru.png" style="max-width: 750px; border: 1px solid #efefef;">
 
+<a name="filter-lists"></a>
 
+## Фильтры
 
-<a name="html"></a>
+Чтобы понимать, как работает блокировка рекламы, вначале надо разобраться в основополагающих принципах работы фильтров.
 
-#### Фильтрация кода страницы
+Правила фильтрации, из которых состоят фильтры, не создаются сами собой. Они являются результатом кропотливой работы разработчиков фильтров, как профессионалов, так и волонтёров. Разработчики используют консоль браузеров и другие инструменты (такие, как Журнал фильтрации AdGuard), чтобы определять, какое правило нужно для блокировки конкретной рекламы или трекера. Это очень упрощённое описание процесса: в особо трудных случаях могут потребоваться сразу несколько правил, множество итераций и использование сложного синтаксиса, чтобы заблокировать элемент.
 
-Перед тем как страница будет получена браузером, AdGuard обрабатывает ее код, удаляя элементы в соответствии с рекламными фильтрами. Таким образом браузер не узнает о том, что на странице вообще были эти элементы, и не будет пытаться их подгрузить.
+Даже когда правило попадает в фильтр, оно не остаётся там навсегда. Реклама и способ её подачи могут поменяться, и правила фильтрации должны меняться вслед за ними. Иногда правила устаревают и больше не нужны, иногда появляется новая реклама и требуются новые правила, а иногда уже существующее правила требуется доработать. Поэтому фильтры требуют постоянной поддержки, и часто эту поддержку осуществляет всего один человек. Но даже в случае с целой командой разработчиков фильтров невозможно представить, чтобы они постоянно мониторили все сайты в интернете. Поэтому многие блокировщики имеют встроенный функционал, чтобы дать пользователям простой способ сообщать о пропущенной рекламе и любых других проблемах с фильтрами, с которыми они сталкиваются.
 
-![Adguard: фильтрация кода страницы](https://images.adguard.com/public/Adguard/Common/page_filtering.png)
+<img src="https://cdn.adguard.com/public/Adguard/Blog/manifestv3/filtersupdates_ru.png" style="max-width: 750px; border: 1px solid #efefef;">
 
-Этот механизм используется **только в AdGuard для Windows, macOS и Android (при включенном высоком качестве фильтрации)**. Дело в том, что возможности браузерных расширений ограничены, и они не могут изменять код страницы до того, как ее обработает браузер.
+Пользователи AdGuard [могут отправлять такие отчёты при помощи специальной веб-утилиты](https://reports.adguard.com/new_issue.html). Благодаря жалобам пользователей разработчики могут сфокусироваться на исправлении и дополнении фильтров, а не на поиске пропущенной рекламы по всей сети.
 
+Фильтры могут гораздо больше, чем просто блокировать рекламные элементы. Существуют фильтры для блокировки трекеров, виджетов социальных сетей, раздражающих элементов (вроде уведомлений о cookie) и т.д. Разные пользователи могут выбирать разные комбинации фильтров, чтобы подстроить фильтрацию под свои нужды. Существуют специальные сайты, такие, как [filterlists.com](https://filterlists.com/), где собраны огромные базы всевозможных фильтров.
 
+> Мы разрабатываем и поддерживаем [свой собственный набор фильтров](https://kb.adguard.com/ru/general/adguard-ad-filters), которые можно использовать как внутри AdGuard, так и с другими блокировщиками.
 
-<a name="block"></a>
+<a name="types-filtering"></a>
 
-#### Блокировка запросов
+## Типы правил фильтрации
 
-Браузер подгружает на страницу все необходимые элементы, основываясь на полученном коде. AdGuard, основываясь на правилах фильтрации, может заблокировать загрузку рекламных элементов, например, баннеров или флэш-объектов.
+Существует множество видов правил фильтрации, служащих различным целям. В зависимости от используемого вами блокировщика и в особенности от вашей операционной системы, те или иные виды правил могут не поддерживаться.
 
-![Adguard: блокировка запросов](https://images.adguard.com/public/Adguard/Common/url_filtering.png)
+<a name="basic"></a>
 
+### Базовые правила
 
+Чтобы вы увидели рекламу на веб-странице или в приложении, её  сначала необходимо загрузить с сервера. Для этого браузер или приложение должны отправить веб-запрос. Самый простой способ предотвратить загрузку рекламы — заблокировать этот запрос, так что он никогда не попадёт на сервер, а значит и реклама не загрузится.
 
-<a name="inject"></a>
-
-#### Инъекция CSS и Javascript
-
-Не вся реклама может быть заблокирована на первых двух этапах. Иногда встречается такая реклама, которая внедряется в страницу динамически, с помощью Javascript, и не требует подгрузки дополнительных элементов, которые мы могли бы заблокировать.
-
-CSS - это специальный язык, используемый для оформления веб-страниц. Стиль отображения элементов веб-страницы можно задавать с помощью правил. Под стилем мы понимаем цвет, шрифт, расположение, и даже видимость элемента. Именно это нас и интересует — мы же хотим скрыть баннер от ваших глаз. Javascript - это также специальный язык, который позволяет динамически изменять любой элемент на странице.
-
-
+Практически все продукты из семейства AdGuard могут блокировать веб-запросы в соответствии с активными правилами фильтрации. Этот метод является одним из самых эффективных в плане блокировки рекламы, но у него есть и недостатки. Самый очевидный из всех — на месте заблокированной рекламы может остаться пустое место.
 
 <a name="cosmetic"></a>
 
-#### Постобработка страницы
+### Косметические правила
 
-Этот этап применяется только браузерными расширениями. Необходимость в нем обусловлена тем, что первый этап обработки (фильтрация кода страницы) для них недоступен. Во время постобработки браузерное расширение удаляет с веб-страницы все элементы, загрузка которых была заблокирована. Если мы не будем их удалять, вы можете увидеть на странице недогруженные элементы, например "битые" изображения.
+Каждая веб-страница имеет так называемый DOM ("document object model" или "объектная модель документа"), по сути — HTML-документ, содержащий структуру страницы и всех её элементов. Реклама на странице тоже является элементом и, следовательно, отображается в DOM. Блокировщики могут убирать часть DOM, а правила фильтрации помогают им понять, какие именно куски DOM соответствуют рекламе и требуют удаления, а какие не стоит трогать.
 
+Этот метод позволяет, например, избежать остатков рекламы, вроде пустых кусков страницы, но также и выполнять другие, более сложные задачи.
 
+<a name="html"></a>
 
-<a name="report"></a>
+### HTML-правила
 
-## Хотите нам помочь?
+В большинстве случаев вышеупомянутых базовых и косметических правил достаточно, чтобы скрыть или заблокировать всю рекламу. Но иногда требуется изменить сам HTML-код страницы ещё до того, как она будет загружена. Для этого существуют правила фильтрации HTML-контента. Такие правила указывают блокировщику на элементы HTML, которые нужно вырезать из кода ещё до загрузки страницы браузером.
 
-Все рекламные фильтры создаются вручную, основываясь на жалобах пользователей на рекламу. Вы можете отправить нам жалобу на рекламу с помощью самой программы, или написать об этом [на нашем форуме](http://forum.adguard.com/forumdisplay.php?69-%D0%A4%D0%B8%D0%BB%D1%8C%D1%82%D1%80%D1%8B-Adguard).
+Это весьма сложный тип правил, и он требует от блокировщика наличия определённых прав, поэтому поддерживается не на всех платформах. HTML-правила работают в приложениях AdGuard для Windows, Mac и Android, а также в браузерном расширении AdGuard для Firefox.
+
+> Есть и другие типы правил фильтрации, но для их понимания необходим ещё более высокий уровент технической подготовки. Если вам интересно, [вы можете ознакомиться с подробным описанием правил фильтрации](https://kb.adguard.com/ru/general/how-to-create-your-own-ad-filters) в статье по ссылке.

01.general/10.why-is-adguard-better/docs.zh.md

@@ -0,0 +1,47 @@
+---
+title: '为什么 AdGuard 比其他广告过滤器更好'
+taxonomy:
+    category:
+        - docs
+visible: true
+---
+
+AdGuard 经常被与众所周知的浏览器拓展 -- Adblock 和 Adblock Plus 作比较。在这篇文章里，我们将比较 AdGuard 所具有的主要优势而它的竞争者却不具备的。
+
+AdGuard 的优势主要是源于采用基于浏览器的拓展的限制。Adblock 和 Adblock Plus 从技术上来说并不能删除网页里的所有广告。这是因为 AdGuard 在页面被加载到浏览器之前就删除了所有的广告元素。拓展基于浏览器的广告过滤功能的一种与 AdGuard 不同的原理工作。这就是为什么需要额外的页面后期处理来隐藏被阻止的元素。如果你曾经使用过 Adblock，那么你一定注意过隐藏横幅是如何“闪烁”的。
+
+<img src="https://kb.adguard.com/user/pages/01.general/10.why-is-adguard-better/banner.png" />
+
+AdGuard 的第二个优势在于它是一个单独的程序，而不是一个浏览器拓展。AdGuard 可以拦截任何浏览器里的广告。无论你使用什么浏览器，无论它是 Google Chrome、Mozilla Firefox、Opera、Internet Explorer 还是 Yandex 等等，有了 AdGuard 你就可以忘掉烦人的在线广告了。
+
+如果你使用一个小众的浏览器，对于 Adblock 和 Adblock Plus 来说可能是个问题，因为这些拓展只能在最流行的浏览器中使用。使用 AdGuard 你就没有这些问题了。你可以很轻易地把你的浏览器添加到保护列表里。
+
+<img src="https://cdn.adguard.com/public/Adguard/kb/newscreenshots/Zh/add_app_cn.png" />
+
+这还不是所有的。AdGuard 可以拦截 Skype、uTorrent 和许多其他的应用程序里的广告。只需要将他们添加到浏览器列表并且重启。
+
+除了拦截广告，AdGuard 提供了许多额外的工具。可能最重要的就是网络钓鱼过滤器。这个模块的运行建立在使用不断更新的恶意网站和钓鱼网站黑名单的基础之上。AdGuard 使用两个主要的资源。一个是谷歌安全浏览列表，一个是 AdGuard 自己的黑名单。我们一直在监控有关网站安全性的数据并且迅速改进我们的过滤器。
+
+<img src="https://cdn.adguard.com/public/Adguard/kb/newscreenshots/Zh/warning_cn.png" />
+
+一些用户使用 AdGuard 替代反病毒软件，一些一起使用。在任何情况下，AdGuard 都认真地提升你的电脑在网络上的安全性。
+
+又一个常见的误解是 Adblock 和 Adblock Plus 几乎不消耗资源。但是真的是这样吗？
+
+为了验证这一点我们将使用 Google Chrome 浏览器里的 Task Manager。
+
+<img src="https://kb.adguard.com/user/pages/01.general/10.why-is-adguard-better/task%20manager.png" />
+
+请注意即使在最简单的设置和一个过滤器启用的情况下，拓展消耗了 100M 的 RAM。AdGuard 消耗了几乎相同的资源的同时还提供了更多的功能。
+
+总结：
+
+**1. AdGuard 在它们加载到浏览器之前就过滤广告。**
+
+**2. AdGuard 可以节省你的流量。**
+
+**3. AdGuard 可以在任何浏览器里工作。**
+
+**4. AdGuard 可以移除来自 Skype、uTorrent 和其他软件的广告。**
+
+**5. AdGuard 可以保护你远离病毒和钓鱼网站。**

02.windows/02.installation/docs.ja.md

@@ -0,0 +1,119 @@
+---
+title: インストール/アンインストール
+taxonomy:
+    category:
+        - docs
+---
+
+## 動作環境
+
+**オペレーティングシステム**: Microsoft Windows 10、8.1、8、7、Vista。
+
+**RAM:** 512MB以上
+
+**ディスクの空き容量:** 150MB
+
+**ブラウザ:** Microsoft Edge、Microsoft Internet Explorer (全バージョン)、Opera、Google Chrome、Yandex.Browser、Mozilla Firefox、およびその他のブラウザ。
+
+
+## AdGuardのインストール方法
+
+Microsoft Windowsを搭載したPCやタブレットでAdGuardを使用するには、インストールパッケージをダウンロードして、インストールプログラムを起動する必要があります。
+以下の操作を行ってください:
+
+1) お使いのブラウザで[adguard.com](http://adguard.com)を開き、「**ダウンロード**」ボタンを押す
+
+<img src="https://cdn.adguard.com/public/Adguard/kb/installation/Win/ja/W1-ja.png" width="600" />
+
+2) ダウンロードが完了しましたら、ダウンロードバーにある「実行」ボタンを押すか、「adguardInstaller.exe」ファイルを押してください。
+
+<img src="https://cdn.adguard.com/public/Adguard/kb/installation/Win/ja/W2-ja.png" />
+
+3) ユーザーアカウント制御のダイアログボックスが表示されてアプリがPCに変更を加えることを許可するよう求められた場合は、「はい]をクリックしてください。
+
+<img src="https://cdn.adguard.com/public/Adguard/kb/newscreenshots/En/Windows7.1/yesEn.png" />
+
+4) AdGuardのPC上インストール先を選ぶ
+
+<img src="https://cdn.adguard.com/public/Adguard/kb/installation/Win/ja/W3-ja.png" width="500" />
+
+デフォルトのインストール先を変更したい場合は、「**参照**」を押して、「**フォルダを参照**」ウィンドウでAdGuardをインストールするフォルダを選択し、**OK**をクリックして選択を確定してください。
+また、**新規フォルダを作成**をクリックしてフォルダ名を入力することで、AdGuardを新しいフォルダにインストールすることもできます。
+
+AdGuardのデスクトップのショートカットを作成するには、「**デスクトップにショートカットを作成**」ボックスをチェックします。
+
+「**インストール**」を押して、インストールを続行します。
+
+<img src="https://cdn.adguard.com/public/Adguard/kb/installation/Win/ja/W4-ja.png" width="500" />
+
+5) インストールが完了しましたら、「**終了**」を押す
+
+<img src="https://cdn.adguard.com/public/Adguard/kb/installation/Win/ja/W5-ja.png" width="500" />
+
+6) インストールが完了すると、AdGuardの主な機能について説明を受けることができます。アプリのチュートリアルを開始し、主要な設定を段階的にカスタマイズするには、「**はじめる**」をクリック。
+このステップをスキップしたい場合は、 「**このままでOK**」 を押します。
+
+<img src="https://cdn.adguard.com/public/Adguard/kb/installation/Win/ja/W6-ja.png" width="500" />
+
+おめでとうございます。お使いのコンピュータにAdGuardが正常にインストールされました。画面には、アプリの設定を変更できるメインウィンドウが表示されます。
+
+<a name="uninstall"></a>
+## AdGuardのアンインストールと再インストール方法
+
+### 通常方法 
+
+AdGuardをアンインストールまたは再インストールする必要がある場合は、以下の操作を行ってください。
+
+【Microsoft Windows 10の場合】
+
+ **スタート**をクリックして**スタートメニュー**を開き、**設定**を選択します。開いたウィンドウで**アプリ**アイコンをクリックします。**アプリ**ウィンドウの左の一覧から**アプリと機能**を選択します。インストールされているアプリの一覧から「**AdgGuard**」を選択し、「**アンインストール**」をクリックします。開いたダイアログボックスで「**アンインストール**」をクリックして確認します。
+
+<img src="https://cdn.adguard.com/public/Adguard/kb/installation/Win/ja/W7-ja.png" />
+
+【Microsoft Windows 7の場合】
+
+**スタートメニュー**を開きます。検索ボックスに「**コントロールパネル**」と入力します。**プログラム**セクションで**プログラムのアンインストール**をクリックし、インストールされたアプリのリストから**AdGuard**を選択して、リストの真上にある**アンインストール**ボタンを押します。開いたウィンドウで**AdGuardのアンインストール**をクリックして動作を確認します。
+
+<img src="https://cdn.adguard.com/public/Adguard/kb/installation/Win/ja/W8-ja.png" />
+
+通常のアンインストール方法が何らかの理由で機能しない場合は、下の**アドバンスド方法**を使用してみてください。
+
+お使いのPCにAdGuardを再インストールするには、インストールプログラムを再度起動し、上記「AdGuardのインストール方法」項目の手順を繰り返してください。
+
+【Microsoft Windows 8の場合】
+
+タスクバーの左下にある**空のスペース**を右クリックし、**コントロールパネル**を選択します。**プログラム**セクションで**プログラムのアンインストール**をクリックし、インストールされているアプリのリストから**AdGuard**を選択して、リストの真上にある**アンインストール**ボタンを押します。開いたウィンドウで「AdGuardのアンインストール」をクリックして動作を確認します。
+
+<img src="https://cdn.adguard.com/public/Adguard/kb/PicturesEN/windows8.png" style="border: 1px solid #efefef; max-width: 600px" />
+
+【Microsoft Windows 8.1の場合】
+
+**スタートボタン**を右クリックし、**コントロールパネル**を選択します。**プログラム**セクションで**プログラムのアンインストール**をクリックし、インストールされているアプリのリストから**AdGuard**を選択して、リストの真上にある**アンインストール**ボタンを押します。開いたウィンドウで**AdGuardのアンインストール**をクリックして動作を確認します。
+
+### アドバンスド方法
+まず、AdGuardの開発者が作成したアンインストーラーツールをダウンロードする必要があります。方法は以下の通りです:
+[このリンク](https://cdn.adguard.com/public/Adguard/tools/Uninstall_Utility.zip")をクリックしてください。
+アーカイブをお使いのPCの任意のフォルダに解凍し、 「**Adguard_Uninstall_Utility.exe**」ファイルを実行してください。
+その後、以下の手順に行なってください。
+
+* <em>&rsquo;Standard uninstall&rsquo;</em> を選択して <em>&rsquo;Uninstall&rsquo;</em>　をクリックしてください
+
+![](https://cdn.adguard.com/public/Adguard/Ru/Articles/howtodelete/main_menu.png)
+                                 
+* アンインストールが完了するまで待つと、ウィンドウに文字列が表示されます:
+                            <pre>"[OK] Uninstall finished"</pre>
+                            
+![](https://cdn.adguard.com/public/Adguard/Ru/Articles/howtodelete/standard_uninstall.png)
+
+<b>【注意】</b> 最初の2つのステップを実行した後、何らかの理由で十分ではなかった場合にのみ、ステップ3と4を行なってください。通常、AdGuardの再インストールが正しく行われていないことが原因であると考えられますが、アドバンスドアンインストール手順の3と4を行う前に、弊社サポートにお問い合わせいただくことを強くお勧めします。
+
+* <em>&rsquo;Advanced uninstall&rsquo;</em> を選択して <em>&rsquo;Uninstall&rsquo;</em> をクリック
+
+![](https://cdn.adguard.com/public/Adguard/Ru/Articles/howtodelete/main_menu_adv.png)
+                                 
+* アンインストールが完了するまで待つと、ウィンドウに文字列が表示されます:
+                            <pre>"[OK] Uninstall finished"</pre>
+
+![](https://cdn.adguard.com/public/Adguard/Ru/Articles/howtodelete/advanced_uninstall.png)
+                                 
+AdGuardのアンインストール完了です！                          

02.windows/04.solving-problems/03.adguard-logs/docs.en.md

@@ -34,7 +34,7 @@ For analysis and diagnostic of different problems support service might need AdG
 
 2. Open the console (type 'cmd' in the start panel).
 
-3. Run the app with the command `C:\"Program Files (x86)"\Adguard\Adguard.exe /trace` if you are using 64-bit Windows, and C:\Program Files\Adguard\Adguard.exe /trace in case if you use 32-bit one.
+3. Run the app with the command `C:\"Program Files (x86)"\Adguard\Adguard.exe /trace` if you are using 64-bit Windows, and C:\"Program Files"\Adguard\Adguard.exe /trace in case if you use 32-bit one.
 
 4. Select **Debug** logging level.
 

02.windows/04.solving-problems/03.adguard-logs/docs.ru.md

@@ -34,7 +34,7 @@ visible: true
 
 2. Откройте консоль (введите 'cmd' в стартовой панели).
 
-3. Запустите приложение командой `C:\"Program Files (x86)"\Adguard\Adguard.exe /trace` (если вы используете 64-битный Windows) или C:\Program Files\Adguard\Adguard.exe /trace (если вы используете 32-битный).
+3. Запустите приложение командой `C:\"Program Files (x86)"\Adguard\Adguard.exe /trace` (если вы используете 64-битный Windows) или C:\"Program Files"\Adguard\Adguard.exe /trace (если вы используете 32-битный).
 
 4. Выберите уровень логирования **Подробный**.
 

02.windows/04.solving-problems/09.common-installer-errors/docs.ru.md

@@ -20,9 +20,7 @@ visible: true
  
 <a id="error-5"></a>
 ### Ошибка 5: Отказано в доступе
-​
 Эта ошибка возникает, когда что-то не в порядке с разрешением на доступ. Почему у установщика AdGuard нет разрешения, которое требуется для завершения установки, может объясняться рядом причин. Выполните следующие действия:
-​
 - Временно отключите антивирусы. Некоторые из них могут мешать установке, это зависит от степени жёсткости ваших настроек.
 ​
 - Выберите другую папку установки – возможно, что у текущей папки есть ограничения доступа. Также удостоверьтесь, что не выбрали внешний или виртуальный жёсткий диск.
@@ -32,9 +30,7 @@ visible: true
 <a id="error-112"></a>
 <a id="error-1632"></a>
 ### Ошибка 112: Недостаточно места на диске, Ошибка 1632: Временная папка переполнена или к ней нет доступа
-​
 Две разные ошибки с очень похожими решениями. Как видно из названия, в обоих случаях установщик AdGuard не нашёл достаточно места, чтобы завершить процесс. Вот что вы можете попробовать, чтобы устранить проблему:
-​
 - Удалите некоторые программы или ненужные файлы с вашего диска, на который вы пытались установить AdGuard.
  
 - Загрузите, установите и запустите [AdwCleaner](http://www.bleepingcomputer.com/download/adwcleaner/), бесплатный инструмент от Malwarebytes. Помимо прочего, он очистит вашу систему от файлов, оставшихся после неправильно удалённых программ. Это освободит место на диске.
@@ -43,9 +39,7 @@ visible: true
 ​
 <a id="error-1601"></a>
 ### Ошибка 1601: Нет доступа к службе установки Windows
-​
 Можно сказать, что это частный случай Ошибки 1603. Возможные решения аналогичны:
-​
 - Запустите и пройдите перерегистрацию службы установщика Microsoft. На это потребуется некоторое время.
 ​
    1) Нажмите комбинацию клавиш **Win + R** и введите ***services.msc***.
@@ -58,9 +52,7 @@ visible: true
 
 <a id="error-1602"></a>
 ### Ошибка 1602: Отменено пользователем
-​
 Если у вас этот код ошибки, весьма вероятно, что вы тем или иным способом прервали процесс установки вручную. Что вы можете сделать:
-​
 - Не закрывайте окно установщика. Когда установка будет завершена, оно закроется автоматически.
 ​
 - Если во время установки всплывает диалоговое окно, нажмите «Да», чтобы предоставить установщику необходимое разрешение. Нажатие «Нет» отменит установку.
@@ -69,10 +61,8 @@ visible: true
 ​
 <a id="error-1603"></a>
 ### Ошибка 1603: Во время установки произошла неустранимая ошибка
-​
 Эта ошибка звучит страшнее, чем она есть на самом деле. На практике это довольно стандартная ошибка, которая может быть обусловлена разными причинами, и некоторые из них легко поправить. Попробуйте следующие решения:
-​
-- Нажите кнопку **Win**, найдите поиском приложение **Командная строка** и запустите её. В открывшемся окне вбейте `sfc /scannow` и нажмите **Enter**.
+- Нажмите кнопку **Win**, найдите поиском приложение **Командная строка** и запустите её. В открывшемся окне вбейте `sfc /scannow` и нажмите **Enter**.
 
 - Выберите другую папку установки. Возможно, что у нынешней папки есть ограничения доступа. Также удостоверьтесь, что не выбрали внешний или виртуальный жёсткий диск.
 
@@ -102,27 +92,21 @@ visible: true
    
 <a id="error-1618"></a>
 ### Ошибка 1618: Уже выполняется другая установка
-​
-Эта ошибка возникает, когда установщик AdGuard запущен несколько раз. Что делать:
-​
+Эта ошибка возникает, когда установщик AdGuard запущен несколько раз. Что делать:​
 - Перезагрузите компьютер и запустите установщик заново. Когда вы сделаете это, все текущие процессы будут остановлены, включая копии установщика.
 ​
 - Не нажимайте на установщик несколько раз, если он не запускается сразу. Иногда отображение интерфейса может занять несколько секунд.
 ​
 <a id="error-1638"></a>
 ### Ошибка 1638: Другая версия этой программы уже установлена
- 
 Очень вероятно, что вы ранее устанавливали AdGuard.
-​
 - Проверьте, установлен ли AdGuard у вас на компьютере. Вы можете сделать это, нажав клавишу **Win** и введя ***AdGuard***.
 ​
 - Может быть, у вас остались файлы от предыдущей установки AdGuard. Удалите AdGuard, используя наше специальное [средство удаления](https://kb.adguard.com/ru/windows/installation#%D1%83%D0%B4%D0%B0%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B8-%D0%BF%D0%B5%D1%80%D0%B5%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-adguard) и повторите установку.
 ​
 <a id="other"></a>
 ### Другие ошибки
-​
 Если вы обнаружили ошибку, которая не перечислена выше, возможно, что мы можем её решить. Но чтобы это сделать, нам нужны ваши логи (файлы журналов). Пожалуйста, выполните следующие шаги:
-​
 - Найдите и архивируйте **файлы журнала установки AdGuard**, как описано в [этой статье](https://kb.adguard.com/ru/windows/solving-problems/installation-logs).
 - Найдите и сохраните на диск логи «Просмотра событий». [Наша статья](https://kb.adguard.com/ru/windows/solving-problems/system-logs) объясняет, как это сделать.
 - Пожалуйста, отправьте файлы из двух предыдущих шагов на **[support@adguard.com](mailto:support@adguard.com)** и опишите проблему в тексте сообщения. Наши специалисты технической поддержки ответят вам в кратчайшее время.

03.macos/02.installation/docs.ja.md

@@ -0,0 +1,101 @@
+---
+title: ‘インストール/アンインストール’
+taxonomy:
+    category:
+        - docs
+---
+* [動作環境](#system-requirements)
+* [インストール方法](#installation)
+* [アンインストール方法](#uninstall)
+	* [アドバンスド・アンインストール](#uninstall-advanced)
+
+<a id="system-requirements"></a>
+## 動作環境
+
+**OSバージョン:** macOS 10.12 (64 bit) 以上
+
+**RAM:** 2 GB以上
+
+**対応ブラウザ:** Safari, Google Chrome, Opera, Yandex.Browser, Mozilla Firefox, およびその他のmacOSと互換性のあるブラウザ
+
+**空きディスク容量:** 120 MB
+
+<a id="installation"></a>
+## AdGuard for Macのインストール方法
+
+AdGuard for Macをインストールするには、ブラウザで [adguard.com](http://adguard.com) を開き、「**ダウンロード**」ボタンを押してください。
+
+<img src="https://cdn.adguard.com/public/Adguard/kb/installation/Mac/ja/mac-1.png" width="600" />
+
+「**AdguardInstaller.dmg**」がダウンロード完了したら、クリックします。（Finderから開くこともできます。）
+
+<img src="https://cdn.adguard.com/public/Adguard/kb/installation/Mac/ja/mac-2.png" width="600" />
+
+表示されたインストールアプリでAdGuardアイコンをダブルクリックしてください。
+
+<img src="https://cdn.adguard.com/public/Adguard/kb/installation/Mac/ja/mac-3.png" width="300" />
+
+AdGuard初インストールの際に、OSからの警告が表示されますので、「**開く**」を押してください。
+
+<img src="https://cdn.adguard.com/public/Adguard/kb/installation/Mac/ja/mac-4.png" width="400" />
+
+次に、「**インストール**」を押してください。
+
+<img src="https://cdn.adguard.com/public/Adguard/kb/installation/Mac/ja/mac-5.png" width="300" />
+
+インストーラが必要なファイルをダウンロード完了するのをお待ちください。
+
+<img src="https://cdn.adguard.com/public/Adguard/kb/installation/Mac/ja/mac-6.png" width="500" />
+
+AdGuardアプリを使用するにはmacOS管理者アカウントのパスワードが必要になります。パスワードを入力して「**OK**」を押してください。
+
+<img src="https://cdn.adguard.com/public/Adguard/kb/installation/Mac/ja/mac-7.png" width="300" />
+
+次に、自分に合わせて設定を簡単にカスタマイズできるチュートリアル画面表示されます。「はじめる」を押して微調整を開始するか、「スキップ」を押して今はスキップすることができます。
+
+<img src="https://cdn.adguard.com/public/Adguard/kb/installation/Mac/ja/mac-8.jpg" width="600" />
+
+これで、お使いのMacへのAdGuardインストールは完了です！
+
+<a id="uninstall"></a>
+## アンインストール
+
+### レギュラー
+まず、Finderを開いてください。
+
+![](https://cdn.adguard.com/public/Adguard/En/Articles/howtodelete/finder.png)
+
+「アプリケーション」→「AdGuard」アイコンを右クリック→「こみ箱に入れる」
+
+<img src="https://cdn.adguard.com/public/Adguard/kb/installation/Mac/ja/mac-9.jpg" width="600" />
+
+レギュラーアンインストール完了です。
+
+<a id="uninstall-advanced"></a>
+### アドバンスド
+
+**※この手順は、技術的なことが分かる場合、またはAdGuardサポートに「アドバンスドアンインストール」を推奨された場合にのみ使用してください。また、先に「レギュラーアンインストール」の手順をすべて行ってください。**
+
+その後、以下の手順を行ってください。
+
+* 以下のAdGuardファイルを削除してください:
+    * */Library/Application Support/com.adguard.mac.adguard* (folder)
+    * *~/Library/Application Support/com.adguard.mac.adguard* (folder)
+    * *~/Library/Preferences/com.adguard.mac.adguard.plist* (file)
+
+**これらを削除するには**、Terminalアプリを開き、以下のコマンドを入力して実行してください:
+
+`sudo rm -R "/Library/Application Support/com.adguard.mac.adguard"`
+`rm -R "~/Library/Application Support/com.adguard.mac.adguard"`
+`rm ~/Library/Preferences/com.adguard.mac.adguard.plist`
+
+* 「アクティビティモニタ」アプリを起動する
+* 検索ツールを使用して「**cfprefsd**」プロセスを見つける
+
+<img src="https://cdn.adguard.com/public/Adguard/kb/installation/Mac/en/uninstall/2.png" width="600" />
+
+* ユーザーで実行されているプロセス（ルートで実行されているものではないほう）を停止します。そうするにはプロセスをクリックして、左上の「X」をクリックしてください。表示されたダイアログで確認してください。 
+
+<img src="https://cdn.adguard.com/public/Adguard/kb/installation/Mac/en/uninstall/3.png" width="400" />
+
+AdGuardアドバンスドアンインストール完了です。

03.macos/05.solving-problems/01.install-cert/docs.en.md

@@ -18,6 +18,8 @@ To manually install the certificate into Firefox-like browser:
   
   4. Navigate to "Authorities" tab and click on "Import..." button
   
-  5. Select file `/Library/Application Support/com.adguard.Adguard/NfApiConfiguration/SSL/Adguard Personal CA.cer`  or just download it from http://local.adguard.org/cert using a Chromium-based browser (e.g Google Chrome or new Edge) and with a HTTPS-filtering running in AdGuard
+  5. Select file `/Library/Application Support/com.adguard.mac.adguard/AdguardCore/Adguard Personal CA.cer`  or just download it from http://local.adguard.org/cert using a Chromium-based browser (e.g Google Chrome or new Edge) and with a HTTPS-filtering running in AdGuard
   
 Exact actions required for different Gecko-based browsers may vary, but the general sequence and the path to `AdGuard Personal CA.cer` file will be the same.
+
+PS: For [Setapp application version](https://setapp.com/apps/adguard) the file path is the following: `/Library/Application Support/com.adguard.mac.adguard-setapp/AdguardCore/Adguard Personal CA.cer`

03.macos/05.solving-problems/01.install-cert/docs.ru.md

@@ -18,6 +18,8 @@ visible: true
   
   4. Перйдите во вкладку "Центры сертификации" и кликните по кнопке "Импортировать..."
   
-  5. Выберите файл `/Library/Application Support/com.adguard.Adguard/NfApiConfiguration/SSL/Adguard Perosnal CA.cer` или скачайте его через любой браузер на основе Chromium (например, Google Chrome или новый Edge) с запущенной HTTPS-фильтрацией в AdGuard
+  5. Выберите файл `/Library/Application Support/com.adguard.mac.adguard/AdguardCore/Adguard Personal CA.cer` или скачайте его через любой браузер на основе Chromium (например, Google Chrome или новый Edge) с запущенной HTTPS-фильтрацией в AdGuard
   
 Точные действия могут различаться для разных браузеров, но общая последовательность и путь к файлу `AdGuard Personal CA.cer` остаются теми же.
+
+P.S: Для [версии приложении в Setapp](https://setapp.com/ru/apps/adguard) путь файла будет такой: `/Library/Application Support/com.adguard.mac.adguard-setapp/AdguardCore/Adguard Personal CA.cer`

06.safari/01.overview/docs.en.md

@@ -27,18 +27,30 @@ It’s free and it will protect you from ads, trackers, phishing, and malicious
 <a name="general"></a>
 
 ## General
-<img src="https://cdn.adguard.com/public/Adguard/Blog/AG_for_Safari_in-depth_review/General.png" style="border: 1px solid #efefef; max-width: 750px; padding: 2px;">
-<p align="center"><i>The General tab</i></p>
+<div style="display:flex">
+     <div style="flex:1;padding-right:5px;">
+          <img src="https://cdn.adguard.com/public/Adguard/Blog/AG_for_Safari_in-depth_review/General.png" style="border: 1px solid #efefef; max-width: 350px; padding: 2px;">
+     </div>
+     <div style="flex:1;padding-left:5px;">
+          <img src="https://cdn.adguard.com/public/Adguard/Blog/AG_for_Safari_in-depth_review/General1.png" style="border: 1px solid #efefef; max-width: 350px; padding: 2px;">
+     </div>
+</div>
 
 The first tab is the General screen where you can set up basic things like notifications, update intervals, and launching AdGuard at system startup. You can also choose to display the AG icon in the menu bar. And most importantly, you can choose which content blockers you’re going to use, but more on that later.
 
 <a name="filters"></a>
 
 ## Filters
-<img src="https://cdn.adguard.com/public/Adguard/Blog/AG_for_Safari_in-depth_review/Filters.png" style="border: 1px solid #efefef; max-width: 800px; padding: 2px;">
-<p align="center"><i>The Filters tab</i></p>
+<div style="display:flex">
+     <div style="flex:1;padding-right:5px;">
+          <img src="https://cdn.adguard.com/public/Adguard/Blog/AG_for_Safari_in-depth_review/Filters.png" style="border: 1px solid #efefef; max-width: 350px; padding: 2px;">
+     </div>
+     <div style="flex:1;padding-left:5px;">
+          <img src="https://cdn.adguard.com/public/Adguard/Blog/AG_for_Safari_in-depth_review/Filters1.png" style="border: 1px solid #efefef; max-width: 350px; padding: 2px;">
+     </div>
+</div>
  
-A filter is a set of rules that can filter web traffic and, in particular, block advertising content (banners, pop-ups and such) and stop tracking. For the convenience of users we have combined them into thematic categories. Seven categories of filters are at your disposal: *Ad Blocking, Privacy, Social widgets, Annoyances, Security, Language-specific, Custom and Other filters*. If you’re curious to know more about them, here is [an extensive article](https://kb.adguard.com/en/general/adguard-ad-filters) describing them.
+A filter is a list of rules written in a special syntax. Following these rules, content blockers can filter web traffic, in particular, block advertising content (banners, pop-ups and such) and stop tracking. For the convenience of users we have combined them into thematic categories. Eight categories of filters are at your disposal: *Ad Blocking, Privacy, Social widgets, Annoyances, Security, Language-specific, Custom and Other filters*. If you’re curious to know more, here are extensive articles [about AdGuard filters](https://kb.adguard.com/en/general/adguard-ad-filters) and about [ad filtering in general](https://kb.adguard.com/en/general/how-ad-blocking-works).
 
 In the Filters tab you can enable/disable the whole category, or fine-tune separate filters inside it. If you make changes, this would be reflected in the Content Blockers section (located in the General tab). In other words, you can adjust things in the Filters tab and see what has changed in the Content Blockers section.
 
@@ -46,7 +58,6 @@ In the Filters tab you can enable/disable the whole category, or fine-tune separ
 
 ## Content Blockers
 <img src="https://cdn.adguard.com/public/Adguard/Blog/AG_for_Safari_in-depth_review/Contentblockers.png" style="border: 1px solid #efefef; max-width: 800px; padding: 2px;">
-<p align="center"><i>Content Blockers</i></p> 
 
 A сontent blocker is a thematic cluster of filters. For instance, all filters that come within the topic of privacy will be included in the content blocker with the corresponding name — *AdGuard Privacy*. There were two reasons to make content blockers: it’s much more convenient to manage structured filters and there still exists Apple’s restriction.
 
@@ -62,7 +73,7 @@ Here is a list of 6 content blockers grouped thematically. The good thing about
 ### AdGuard General
 *AdGuard General* is a category for filters of overall orientation – basically, that’s all you need to know. We recommend that you keep the AdGuard Base filter from here always enabled.
 
-> Please note: to enable any filters, blocking and tracking lists attributed to any given content blocker, you should go to the Filters tab. Here, in the Content blockers section, you can only see what is already enabled and working. 
+> Note that to enable any filters, blocking and tracking lists attributed to any given content blocker, you should go to the Filters tab. Here, in the Content blockers section, you can only see what is already enabled and working. 
  
 <a name="agprivacy"></a>
 
@@ -90,31 +101,9 @@ This content blocker unites several security-related filters. *Malware Domains B
 
 ### AdGuard Custom
 <img src="https://cdn.adguard.com/public/Adguard/Blog/AG_for_Safari_in-depth_review/AGCustom.png" width="800" />
-<p align="center"><i>Adding a custom filter is easy</i></p> 
 
 *AdGuard Custom* is extra space left for supplementary filters you may want to add. Adding a filter is not rocket science. There is no need to know how to create user rules, you can use the ready-made filters. Just enter a valid URL of the filter subscription in the field.
 
-How is AdGuard for Safari different from other popular ad blockers for this browser? Here is a comparison table updated April, 2020.
-
-<img src="https://cdn.adguard.com/public/Adguard/Blog/AG_for_Safari_in-depth_review/comparisontable.png" style="border: 1px solid #efefef; max-width: 800px; padding: 2px;">
-<p align="center"><i>Ad blockers' comparison chart</i></p> 
-
-*⠀300K filtering rules vs. 50K
-
-<a name="whitelist"></a>
-
-## Whitelist
-<img src="https://cdn.adguard.com/public/Adguard/Blog/AG_for_Safari_in-depth_review/Whitelist.png" width="800" />
-<p align="center"><i>Whitelist</i></p> 
-
-To put it simply, Whitelist is a list of exceptions — websites that AdGuard won’t block. If you want to see some ads for a reason (say, you want to support your favorite website), there is a solution.
-
-How does it work? Add a website to Whitelist and ad blocking will be disabled for it. You can add as many websites as needed.
-
-There is an option to import/export a list of exclusions. If you’ve already created one and want to apply it to another device, just press the corresponding button.
-
-> Note: Whitelist can be inverted — this means AdGuard will not block ads and tracking anywhere except for the websites you’ve put on this list.
-
 <a name="userrules"></a>
 
 ## User Rules
@@ -133,4 +122,4 @@ Last but not least important tab. Here you can see what version you have, read E
 
 Finally, there is a link to our repository on GitHub. If you are even a little bit of a geek, it might be of interest to you. You can monitor the product development, create feature requests and report bugs there, for instance. 
 
-> Reminder: AdGuard for Safari can be downloaded for free [from the App Store](https://apps.apple.com/en/app/adguard-for-safari/id1440147259?l=en&mt=12). A detailed setup instruction is available [here](https://www.kb.adguard.com/en/safari/installation).
+> Reminder: AdGuard for Safari can be downloaded for free [from the App Store](https://apps.apple.com/en/app/adguard-for-safari/id1440147259). A detailed setup instruction is available [here](https://www.kb.adguard.com/en/safari/installation).

06.safari/01.overview/docs.ru.md

@@ -1,5 +1,5 @@
 ---
-title: Обзор
+title: Обзор функций
 taxonomy:
     category:
         - docs
@@ -16,7 +16,6 @@ visible: true
 	* [AdGuard Безопасность](#agsecurity)
     * [AdGuard Другие](#agother)
     * [AdGuard Пользовательские](#agcustom)
-* 	[Белый список](#whitelist)
 * 	[Пользовательские правила](#userrules)
 * 	[О программе](#about)
 
@@ -27,32 +26,44 @@ AdGuard для Safari был выпущен в ноябре 2018 года и б
 <a name="general"></a>
 
 ## Общие
-<img src="https://cdn.adguard.com/public/Adguard/Blog/AG_for_Safari_in-depth_review/General_ru.png" style="border: 1px solid #efefef; max-width: 750px; padding: 2px;">
-<p align="center"><i>Общие настройки</i></p>
 
-Первая вкладка – это экран «Общие», где вы можете настроить базовые вещи, такие как уведомления, интервалы, через которые расширение обновляется, и автоматический запуск AdGuard при старте системы. Вы также можете решать, отображать ли значок AG в строке меню. И самое главное, здесь вы можете увидеть, какие блокировщики контента используются в данный момент, но об этом позже.
+<div style="display:flex">
+     <div style="flex:1;padding-right:5px;">
+          <img src="https://cdn.adguard.com/public/Adguard/Blog/AG_for_Safari_in-depth_review/General_ru.png" style="border: 1px solid #efefef; max-width: 350px; padding: 2px;">
+     </div>
+     <div style="flex:1;padding-left:5px;">
+          <img src="https://cdn.adguard.com/public/Adguard/Blog/AG_for_Safari_in-depth_review/General1_ru.png" style="border: 1px solid #efefef; max-width: 350px; padding: 2px;">
+     </div>
+</div>
+
+Первая вкладка – это экран «Общие», где вы можете настроить базовые вещи, такие как уведомления, периоды обновления расширения, и автозапуск AdGuard при входе в систему. Вы также можете решать, отображать ли значок AdGuard в строке меню, включить ли подробное логирование или аппаратное ускорение. С этого экрана можно экспортировать и импортировать настройки и экспортировать логи. И самое главное, здесь вы можете увидеть, какие блокировщики контента используются в данный момент, но об этом позже. 
 
 <a name="filters"></a>
 
 ## Фильтры
-<img src="https://cdn.adguard.com/public/Adguard/Blog/AG_for_Safari_in-depth_review/Filters_ru.png" style="border: 1px solid #efefef; max-width: 750px; padding: 2px;">
-<p align="center"><i>Вкладка «Фильтры»</i></p>
+<div style="display:flex">
+     <div style="flex:1;padding-right:5px;">
+          <img src="https://cdn.adguard.com/public/Adguard/Blog/AG_for_Safari_in-depth_review/Filters_ru.png" style="border: 1px solid #efefef; max-width: 350px; padding: 2px;">
+     </div>
+     <div style="flex:1;padding-left:5px;">
+          <img src="https://cdn.adguard.com/public/Adguard/Blog/AG_for_Safari_in-depth_review/Filters1_ru.png" style="border: 1px solid #efefef; max-width: 350px; padding: 2px;">
+     </div>
+</div>
  
-Фильтр – это набор правил, которые фильтруют веб-трафик, в частности, блокируют рекламный контент (баннеры, всплывающие уведомления и всё такое) и борются с трекингом. Для удобства пользователей мы объединили их в тематические категории. В вашем распоряжении семь категорий фильтров: *Блокировка рекламы, Антитрекинг, Виджеты социальных сетей, Раздражители, Безопасность, Языковые, Пользовательские и Другие фильтры*. Если вам интересно узнать о них больше, рекомендуем прочитать эту [обширную статью](https://kb.adguard.com/ru/general/adguard-ad-filters), описывающую их.
+Фильтр – это набор правил, следуя которым блокировщики фильтруют веб-трафик, в частности, блокируют рекламный контент (баннеры, всплывающие уведомления и другие раздражающие элементы) и борются с трекингом. Для удобства пользователей мы объединили их в тематические категории. В вашем распоряжении восемь категорий фильтров: *Блокировка рекламы, Антитрекинг, Виджеты социальных сетей, Раздражители, Безопасность, Другие, Языковые и Собственные фильтры*. Если вам интересно узнать больше, рекомендуем прочитать статьи [о фильтрах AdGuard](https://kb.adguard.com/ru/general/adguard-ad-filters) и о том, [как работает фильтрация](https://kb.adguard.com/ru/general/how-ad-blocking-works).
 
-Во вкладке «Фильтры» вы можете как включить/отключить целую категорию, так и настроить отдельные фильтры внутри неё. Если вы внесёте изменения, это отразится в разделе «Блокировщики контента», который расположен во вкладке «Общие». Другими словами, во вкладке «Фильтры» вы можете менять вещи, в разделе «Блокировщики контента» – видеть, что изменилось.
+Во вкладке «Фильтры» вы можете как включить/отключить целую категорию, так и настроить отдельные фильтры внутри неё. Если вы внесёте изменения, это отразится в разделе «Блокировщики контента», который расположен во вкладке «Общие». Другими словами, во вкладке «Фильтры» вы можете менять вещи, а в разделе «Блокировщики контента» – видеть, что изменилось.
 
 <a name="contentblockers"></a>
 
 ## Блокировщики контента
 <img src="https://cdn.adguard.com/public/Adguard/Blog/AG_for_Safari_in-depth_review/Contentblockers_ru.png" style="border: 1px solid #efefef; max-width: 750px; padding: 2px;">
-<p align="center"><i>Блокировщики контента</i></p>
 
-Блокировщик контента – это тематическая группа фильтров. Например, все фильтры, объединённые темой конфиденциальности, включены в блокировщик с соответствующим названием — AdGuard Безопасность. «Зачем так всё усложнять?», – можете спросить вы. По сути, на это есть две причины: действующее ограничение Apple и тот факт, что управлять сгруппированными фильтрами гораздо удобнее.
+Блокировщик контента – это тематическая группа фильтров. Например, все фильтры, объединённые темой конфиденциальности, включены в блокировщик с соответствующим названием — *AdGuard Безопасность*. Мы пользуемся таким делением по двум причинам: из-за действующего ограничения Apple и просто потому, что управлять сгруппированными фильтрами гораздо удобнее.
 
 Как вы можете [помнить](https://adguard.com/ru/blog/adguard-safari-1-5.html), Apple наложил ограничения на блокировщики рекламы для Safari, разрешив им использовать только 50 000 правил фильтрации одновременно. Не обманывайтесь этим на первый взгляд большим числом – на самом деле, для правил фильтрации это совсем немного. Например, некоторые наши фильтры сами по себе содержат больше 50 000 правил, и нам даже пришлось оптимизировать часть из них специально для AdGuard для Safari.
 
-К счастью, есть способ обойти это ограничение. Один блокировщик можно разделить на несколько, в каждом из которых будет содержаться до 50 тысяч правил. Эта мера позволяет нам усилить защиту пользователей. 
+К счастью, есть способ обойти это ограничение. Один блокировщик можно разделить на несколько, в каждом из которых будет содержаться до 50 тысяч правил. Эта мера позволяет нам усилить защиту пользователей.
 
 Вот список блокировщиков контента, которые доступны в расширении AdGuard для Safari. Что особенно удобно, вся информация о включённых фильтрах и количестве использующихся правил находится прямо перед глазами. Например:
 > AdGuard Основные
@@ -91,38 +102,14 @@ AdGuard для Safari был выпущен в ноябре 2018 года и б
 <a name="agcustom"></a>   
 
 ### AdGuard Пользовательские
-<img src="https://cdn.adguard.com/public/Adguard/Blog/AG_for_Safari_in-depth_review/AGCustom_ru.png" width="800" />
-<p align="center"><i>Добавить пользовательский фильтр легко</i></p> 
+<img src="https://cdn.adguard.com/public/Adguard/Blog/AG_for_Safari_in-depth_review/AGCustom_ru.png" width="800" /> 
 
-*AdGuard Пользовательские* – это дополнительное пространство, которое мы оставили для фильтров, которые вы, возможно, захотите добавить. Добавить фильтр самому – это не высшая математика. Вам не нужно уметь создавать свои пользовательские правила, можно взять готовый фильтр. Просто введите действительный URL фильтра в поле ниже. К счастью, фильтров существует огромное количество, и их без труда можно найти в интернете, например, на тематических форумах.
-
-Чем AdGuard для Safari отличается от других блокировщиков рекламы для этого браузера? Вот сравнительная таблица на апрель 2020.
-
-<img src="https://cdn.adguard.com/public/Adguard/Blog/AG_for_Safari_in-depth_review/comparisontable_ru.png" style="border: 1px solid #efefef; max-width: 800px; padding: 2px;">
-<p align="center"><i>Сравнительная таблица браузерных блокировщиков</i></p> 
-
-
-*⠀300 тыс. правил фильтрации vs. 50 тыс.
-
-<a name="whitelist"></a>
-
-## Белый список
-<img src="https://cdn.adguard.com/public/Adguard/Blog/AG_for_Safari_in-depth_review/Whitelist_ru.png" width="800" />
-<p align="center"><i>Белый список</i></p> 
-
-Говоря по-простому, Белый список – это список исключений, то есть сайтов, которые AdGuard не будет блокировать. Если вы по какой-то причине хотите видеть рекламу на некоторых сайтах (скажем, хотите поддержать любимый проект), есть решение.
-
-Как это работает? Добавьте сайт в Белый список, и блокировка рекламы для него будет отключена. Вы можете добавить столько сайтов, сколько потребуется.
-
-Также есть возможность импортировать/экспортировать свой список исключений. Если вы уже создали его и хотите применить его на другом устройстве, просто нажмите соответствующую кнопку.
-
-> Важно: Белый список можно инвертировать — это значит, что AdGuard не будет блокировать рекламу и трекинг нигде кроме сайтов, которые вы добавили в этот список.
+*AdGuard Пользовательские* – это дополнительное пространство, которое мы оставили для фильтров, которые вы, возможно, захотите добавить. Добавить фильтр самому не так сложно, как может показаться. Вам не нужно уметь создавать свои пользовательские правила, можно взять готовый фильтр. Просто введите действительный URL фильтра в поле ниже. К счастью, фильтров существует огромное количество, и их без труда можно найти в интернете, например, на тематических форумах.
 
 <a name="userrules"></a>
 
 ## Пользовательские правила
 <img src="https://cdn.adguard.com/public/Adguard/Blog/AG_for_Safari_in-depth_review/Userrules_ru.png" style="border: 1px solid #efefef; max-width: 800px; padding: 2px;">
-<p align="center"><i>Пользовательские правила</i></p> 
 
 Пользовательские правила – это отличная возможность для тех, кто хочет кастомизировать процесс фильтрации. Конечно, чтобы написать и применить своё правило, потребуются определённые навыки: в частности, нужно овладеть синтаксисом правил. Если вы хотите изучить что-то новое, у нас есть для вас [исчерпывающее руководство](https://kb.adguard.com/ru/general/how-to-create-your-own-ad-filters) на эту тему.
 
@@ -136,4 +123,4 @@ AdGuard для Safari был выпущен в ноябре 2018 года и б
 
 Наконец, в этой вкладке лежит ссылка на наш репозиторий на GitHub. Если вы хотя бы чуточку технарь, этот ресурс может оказаться для вас интересным. На GitHub можно отслеживать развитие продукта, оставлять запросы о добавлении функций и, к примеру, сообщать об ошибках. 
 
-> Напоминание: AdGuard для Safari можно скачать бесплатно [из App Store](https://apps.apple.com/ru/app/adguard-for-safari/id1440147259?l=en&mt=12). Подробная инструкция по установке доступна [по этой ссылке](https://www.kb.adguard.com/ru/safari/installation).
+> Напоминание: AdGuard для Safari можно скачать бесплатно [из App Store](https://apps.apple.com/ru/app/adguard-for-safari/id1440147259). Подробная инструкция по установке доступна [по этой ссылке](https://www.kb.adguard.com/ru/safari/installation).

12.miscellaneous/01.acknowledgments/docs.en.md

@@ -209,34 +209,55 @@ This is the list of libraries and other resources that really helped us with AdG
 <a id="testers"></a>
 # Special thanks
 
-Also a huge thanks and gratitude to all beta testers and other engaged users, whose help in finding and eliminating all the bugs was priceless. Special thanks to:
+Also a huge thanks and gratitude to all beta testers and other engaged users, whose help in finding/eliminating all the bugs, translating AdGuard and moderating our communities was priceless. Special thanks to:
 
-* [ag_bug_finder](http://forum.adguard.com/member.php?3639)
-* [Blaz](http://forum.adguard.com/member.php?4656-Blaz)
-* [Boo Berry](http://forum.adguard.com/member.php?1905-Boo-Berry)
-* [buuuuuuu190](http://forum.adguard.com/member.php?3571-buuuuuuu190)
-* [clarke](http://forum.adguard.com/member.php?3985-clarke)
-* [dartrax](https://github.com/dartrax)
-* [dja2k](http://forum.adguard.com/member.php?3933-dja2k)
-* [hanschke](http://forum.adguard.com/member.php?3946-hanschke)
-* [itabmedia](http://forum.adguard.com/member.php?4711-itabmedia)
-* [Lord Ami](http://forum.adguard.com/member.php?5374-Lord-Ami)
-* [milder](http://forum.adguard.com/member.php?4519-milder)
-* [Nicos18](http://forum.adguard.com/member.php?5726-Nicos18)
-* [rickyoh](http://forum.adguard.com/member.php?1507-rickyoh)
-* [Ronin427](http://forum.adguard.com/member.php?4116-Ronin427)
-* [saturnotaku](http://forum.adguard.com/member.php?4782-saturnotaku)
-* [steve1209](http://forum.adguard.com/member.php?3437-steve1209)
-* [streetwolf](http://forum.adguard.com/member.php?3482-streetwolf)
-* [TPS](https://github.com/TPS)
-* fabjazz
-* kirasam
-* malware1
-* ouzbed
-* Sanjay Nand
-* TayTayTheKiller
+* ag_bug_finder - beta tester of AdGuard for Windows
+* Aikatsui – active contributor to AdGuard Home
+* Andy Kleinert (AndyKl) – translator and proofreader to German in Crowdin
+* BigDargon – contributed the hostsVN project as a source to the list of AdGuard DNS
+* Blaz - started as a filter contributor and now working at AdGuard
+* Boo Berry - forum and Telegram group moderator
+* buuuuuuu190 - beta tester, active AdGuard Forum member
+* clarke - beta tester, active AdGuard Forum member
+* [dartrax](https://github.com/dartrax) - beta tester, active AdGuard Forum member
+* dja2k - beta tester, active AdGuard Forum member
+* Eduardo Addad de Oliveira (eduardoaddad) – translator and proofreader to Portuguese and Portuguese, Brazilian in Crowdin
+* fabjazz - beta tester, active AdGuard Forum member
+* Görkem Emrah Güler (gork7777) – translator and proofreader to Turkish in Crowdin
+* hanschke - beta tester, active AdGuard Forum member
+* iDjay – outstanding beta tester of AdGuard for iOS
+* Imre Kristoffer Eilertsen (DandelionSprout) – maintainer of “Dandelion Sprout’s Nordic Filters” that are included in all AdGuard tools
+* IONIL – translator and proofreader to Hebrew in Crowdin
+* itabmedia - beta tester, active AdGuard Forum member
+* kirasam - beta tester, active AdGuard Forum member
+* krystian3w – very active filter contributor
+* lancelot.moon – translator and proofreader to Chinese Traditional in Crowdin, beta tester
+* Lord Ami - beta tester, active AdGuard Forum member
+* malware1 - beta tester, active AdGuard Forum member
+* milder - beta tester, active AdGuard Forum member
+* Nicos18 - beta tester, active AdGuard Forum member
+* Oizaro – translator and proofreader to Italian in Crowdin
+* Oleg Chashko — very active beta tester of AdGuard for Safari
+* Oskari Lavinto (olavinto) – translator and proofreader to Finnish in Crowdin
+* ouzbed - beta tester, active AdGuard Forum member
+* PentagramTr – filter contributor, namely, he has brought a lot of new things to the Turkish filter
+* Peter Hubinsky (hubak) – translator and proofreader to Slovak in Crowdin
+* PiQuark6046 – filter contributor
+* rickyoh - beta tester, active AdGuard Forum member
+* Ronin427 - beta tester, active AdGuard Forum member
+* Sanjay Nand - beta tester, active AdGuard Forum member
+* saturnotaku - beta tester, active AdGuard Forum member
+* steve1209 - beta tester, active AdGuard Forum member
+* streetwolf - beta tester, active AdGuard Forum member
+* superlex – helps us with scriptlets, filters, and AdGuard for Safari
+* TayTayTheKiller - beta tester, active AdGuard Forum member
+* [TPS](https://github.com/TPS) - bug finder, filter contributor
+* Yuki2718 – actively contributes to AdGuard filters
+* zznosar — active beta tester focused on AdGuard for iOS
+* Сергей Зозуля (sviperz) — active member of our Telegram group, beta tester 
 
 ---
+
 We also want to thank the [xda-developers users](https://adguard.com/en/forum.xda-developers.com/android/apps-games/adguard-ad-blocker-doesnt-require-root-t2958895). Thank you for your much helpful feedback!
 
 We always appreciate comments from our users, especially constructive ones :) You can always contact us to share your thoughts about AdGuard, request new features, and submit bugs. Join our [AdGuard Forum](http://forum.adguard.com/forumdisplay.php?25-English-Forums), [Subreddit](https://reddit.com/r/adguard), [Xda-developers Forum](https://adguard.com/en/forum.xda-developers.com/android/apps-games/adguard-ad-blocker-doesnt-require-root-t2958895) or visit our page on [GitHub](https://github.com/AdguardTeam).

12.miscellaneous/01.acknowledgments/docs.ru.md

@@ -208,70 +208,90 @@ visible: true
 <a id="testers"></a>
 # Благодарности
 
-Огромное спасибо всем бета-тестерам и другим пользователям, чья помощь в поиске и устранении ошибок была поистине бесценной. Особая благодарность:
+Также огромное спасибо всем бета-тестерам и другим неравнодушным пользователям, чья помощь в поиске и устранении ошибок, переводе AdGuard и модерации наших сообществ была бесценной. Особая благодарность:
 
-* [dartrax](https://github.com/dartrax)
-* [Petrovic](http://forum.adguard.com/member.php?3037-Petrovic)
-* [leh-stav](http://forum.adguard.com/member.php?2624-leh-stav)
-* [Анатолий1978](http://forum.adguard.com/member.php?3153-%D0%90%D0%BD%D0%B0%D1%82%D0%BE%D0%BB%D0%B8%D0%B91978)
-* [toby_43](http://forum.adguard.com/member.php?371-toby_43)
-* [N3m0s](http://forum.adguard.com/member.php?4159-N3m0s)
-* [Иван Кузенков](http://forum.adguard.com/member.php?2801-%D0%98%D0%B2%D0%B0%D0%BD-%D0%9A%D1%83%D0%B7%D0%B5%D0%BD%D0%BA%D0%BE%D0%B2)
-* [ZP](http://forum.adguard.com/member.php?4531-ZP)
-* [vampir900](http://forum.adguard.com/member.php?809-vampir900)
-* [4pokMEN](http://forum.adguard.com/member.php?5932-4pokMEN)
-* [jesus_c31](http://forum.adguard.com/member.php?2286-jesus_c31)
-* [Хых](http://forum.adguard.com/member.php?1846-%D0%A5%D1%8B%D1%85)
-* [KiLlArMy_Juni](http://forum.adguard.com/member.php?107-KiLlArMy_Juni)
-* [dr_max](http://forum.adguard.com/member.php?3114-dr_max)
-* [iluhin](http://forum.adguard.com/member.php?1764-iluhin)
-* [MisterMyth](http://forum.adguard.com/member.php?6006-MisterMyth)
-* [BigStone](http://forum.adguard.com/member.php?3284-BigStone)
-* [sasanau](http://forum.adguard.com/member.php?3705-rasanau)
-* [focus](http://forum.adguard.com/member.php?5323-focus)
-* Sanjay Nand
-* [fix](http://forum.adguard.com/member.php?4077-fix)
-* [Domovou](http://forum.adguard.com/member.php?2695-Domovou)
-* [D1MSON](http://forum.adguard.com/member.php?6057-D1MSON)
-* [RicuOne](http://forum.adguard.com/member.php?5182-RicuOne)
-* [Fantom](http://forum.adguard.com/member.php?65-Fantom)
-* [WSK](http://forum.adguard.com/member.php?1746-WSK)
-* [Martin_Devil](http://forum.adguard.com/member.php?2148-Martin_Devil)
-* [Gumbo](http://forum.adguard.com/member.php?791-Gumbo)
-* [maxvelamx](http://forum.adguard.com/member.php?506-maxvelamx)
-* [Talisman](http://forum.adguard.com/member.php?80-Talisman)
-* [ArgoS](http://forum.adguard.com/member.php?4023-ArgoS)
-* [re1ko](http://forum.adguard.com/member.php?6171-re1ko)
-* [Maxim PRO](http://forum.adguard.com/member.php?440-Maxim-PRO)
-* [Malahiya](http://forum.adguard.com/member.php?2549-Malahiya)
-* [biomednet](http://forum.adguard.com/member.php?6196-biomednet)
-* [RybakOFF](http://forum.adguard.com/member.php?4260-RybakOFF)
-* [Wusa](http://forum.adguard.com/member.php?4345-Wusa)
-* [Ligre](http://forum.adguard.com/member.php?3681-Ligre)
-* [Hercules](http://forum.adguard.com/member.php?5881-Hercules)
-* [ag_bug_finder](http://forum.adguard.com/member.php?3639)
-* [milder](http://forum.adguard.com/member.php?4519-milder)
-* [Ronin427](http://forum.adguard.com/member.php?4116-Ronin427)
-* [itabmedia](http://forum.adguard.com/member.php?4711-itabmedia)
-* [saturnotaku](http://forum.adguard.com/member.php?4782-saturnotaku)
-* [Ариша](http://forum.adguard.com/member.php?5173-%D0%90%D1%80%D0%B8%D1%88%D0%B0)
-* [Blaz](http://forum.adguard.com/member.php?4656-Blaz)
-* [Boo Berry](http://forum.adguard.com/member.php?1905-Boo-Berry)
-* [buuuuuuu190](http://forum.adguard.com/member.php?3571-buuuuuuu190)
-* [clarke](http://forum.adguard.com/member.php?3985-clarke)
-* [dja2k](http://forum.adguard.com/member.php?3933-dja2k)
-* [hanschke](http://forum.adguard.com/member.php?3946-hanschke)
-* [Lord Ami](http://forum.adguard.com/member.php?5374-Lord-Ami)
-* [Nicos18](http://forum.adguard.com/member.php?5726-Nicos18)
-* [rickyoh](http://forum.adguard.com/member.php?1507-rickyoh)
-* [steve1209](http://forum.adguard.com/member.php?3437-steve1209)
-* [streetwolf](http://forum.adguard.com/member.php?3482-streetwolf)
-* [TPS](https://github.com/TPS)
-* fabjazz
-* kirasam
-* malware1
-* ouzbed
-* TayTayTheKiller
+* ag_bug_finder – бета-тестер AdGuard для Windows
+* Aikatsui – активный контрибьютор AdGuard Home
+* Andy Kleinert (AndyKl) – переводчик и редактор немецкого языка в Crowdin
+* ArgoS – бета-тестер AdGuard для Windows
+* BigDargon – добавил проект hostsVN в качестве источника в список AdGuard DNS
+* BigStone – бета-тестер, активный участник форума AdGuard 
+* biomednet – бета-тестер, активный участник форума AdGuard 
+* Blaz – начинал как контрибьютор, пополняя наши фильтры (а теперь работает в AdGuard)
+* Boo Berry – модератор нашего форума и группы Telegram
+* buuuuuuu190 – бета-тестер, активный участник форума AdGuard 
+* clarke – бета-тестер, активный участник форума AdGuard 
+* D1MSON – бета-тестер, активный участник форума AdGuard 
+* [dartrax](https://github.com/dartrax) – бета-тестер, активный участник форума AdGuard 
+* dja2k – бета-тестер, активный учаcтник форума AdGuard 
+* Domovou – бета-тестер, активный учаcтник форума AdGuard 
+* dr_max – бета-тестер, активный учаcтник форума AdGuard 
+* Eduardo Addad de Oliveira (eduardoaddad) – переводчик и редактор португальского и португальского бразильского языков в Crowdin
+* Fantom – бета-тестер, активный участник форума AdGuard 
+* fabjazz – бета-тестер, активный участник форума AdGuard 
+* fix – бета-тестер, активный участник форума AdGuard
+* focus – бета-тестер, активный участник форума AdGuard 
+* Görkem Emrah Güler (gork7777) – переводчик и редактор турецкого языка в Crowdin
+* Gumbo – бета-тестер, активный участник форума AdGuard 
+* hanschke – бета-тестер, активный участник форума AdGuard 
+* Hercules – бета-тестер, активный участник форума AdGuard 
+* iDjay – выдающийся бета-тестер AdGuard для iOS
+* iluhin – бета-тестер, активный участник форума AdGuard
+* Imre Kristoffer Eilertsen (DandelionSprout) – разработчик "Nordic Filters" от Dandelion Sprout, которые включены во все инструменты AdGuard
+* IONIL – переводчик и редактор иврита в Crowdin
+* itabmedia – бета-тестер, активный участник форума AdGuard 
+* jesus_c31 – бета-тестер, активный участник форума AdGuard 
+* KiLlArMy_Juni – бета-тестер, активный участник форума AdGuard 
+* kirasam – бета-тестер, активный участник форума AdGuard 
+* krystian3w – очень активный разработчик фильтров
+* lancelot.moon – переводчик и редактор традиционного китайского языка в Crowdin, бета-тестер
+* leh-stav – бета-тестер, активный участник форума AdGuard 
+* Ligre – бета-тестер, активный участник форума AdGuard 
+* Lord Ami – бета-тестер, активный участник форума AdGuard 
+* Malahiya – бета-тестер, активный участник форума AdGuard 
+* malware1 – бета-тестер, активный участник форума AdGuard 
+* Maxim PRO – бета-тестер, активный участник форума AdGuard 
+* maxvelamx – бета-тестер, активный участник форума AdGuard 
+* Martin_Devil – бета-тестер, активный участник форума AdGuard 
+* milder – бета-тестер, активный участник форума AdGuard 
+* MisterMyth – бета-тестер, активный участник форума AdGuard 
+* N3m0s – бета-тестер, активный участник форума AdGuard
+* Nicos18 – бета-тестер, активный участник форума AdGuard 
+* Oizaro – переводчик и редактор итальянского языка в Crowdin
+* Oleg Chashko – очень активный бета-тестер AdGuard для Safari
+* Oskari Lavinto (olavinto) – переводчик и редактор финского языка в Crowdin
+* ouzbed – бета-тестер, активный участник форума AdGuard 
+* PentagramTr – разработчик фильтров, очень многое добавил в турецкий рекламный фильтр
+* Peter Hubinsky (hubak) – переводчик и редактор словацкого языка в Crowdin
+* Petrovic – бета-тестер, активный участник форума AdGuard 
+* PiQuark6046 – разработчик фильтров
+* rickyoh – бета-тестер, активный участник форума AdGuard
+* re1ko – бета-тестер, активный участник форума AdGuard
+* RicuOne – бета-тестер, активный участник форума AdGuard
+* Ronin427 – бета-тестер, активный участник форума AdGuard 
+* RybakOFF – бета-тестер, активный участник форума AdGuard 
+* Sanjay Nand – бета-тестер, активный участник форума AdGuard 
+* sasanau – бета-тестер, активный участник форума AdGuard
+* saturnotaku – бета-тестер, активный участник форума AdGuard 
+* steve1209 – бета-тестер, активный участник форума AdGuard 
+* streetwolf – бета-тестер, активный участник форума AdGuard 
+* superlex – помогает нам со скриптлетами, фильтрами и AdGuard для Safari
+* Talisman – бета-тестер, активный участник форума AdGuard 
+* TayTayTheKiller – бета-тестер, активный участник форума AdGuard 
+* toby_43 – бета-тестер, активный участник форума AdGuard 
+* [TPS](https://github.com/TPS) – бета-тестер, разработчик фильтров
+* Yuki2718 – активный контрибьютор, помогает с фильтрами AdGuard
+* vampir900 – бета-тестер, активный участник форума AdGuard 
+* WSK – бета-тестер, активный участник форума AdGuard 
+* Wusa – бета-тестер, активный участник форума AdGuard 
+* ZP – бета-тестер, активный участник форума AdGuard 
+* zznosar – активный бета-тестер, особенно помогает с AdGuard для iOS
+* 4pokMEN – бета-тестер, активный участник форума AdGuard 
+* Анатолий1978 – бета-тестер, активный участник форума AdGuard 
+* Ариша – бета-тестер, активный участник форума AdGuard 
+* Иван Кузенков – бета-тестер, активный участник форума AdGuard 
+* Сергей Зозуля (sviperz) – активный участник нашей группы в Telegram, бета-тестер
+* Хых – бета-тестер, активный участник форума AdGuard 
 
 ---