Merge pull request #454 from AdguardTeam/macos-overview

Mac: Divide Overview into small articles

docs/adguard-for-mac/features/_category_.json

@@ -0,0 +1,6 @@
+{
+    "position": 1,
+    "label": "Features",
+    "collapsible": true,
+    "collapsed": true
+}

docs/adguard-for-mac/features/browser-assistant.md

@@ -0,0 +1,63 @@
+---
+title: Browser Assistant
+sidebar_position: 8
+---
+
+:::info
+
+This article covers AdGuard for Mac, a multifunctional ad blocker that protects your device at the system level. To see how it works, [download the AdGuard app](https://agrd.io/download-kb-adblock)
+
+:::
+
+AdGuard Browser Assistant allows you to manage AdGuard protection directly from your browser.
+
+![The Assistant window *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/mac/assistant_window.png)
+
+## How it works
+
+AdGuard Browser Assistant is a browser extension. It allows you to quickly manage the AdGuard app:
+
+- Enable or disable protection for a specific website (a toggle under the website name)
+- Pause protection for 30 seconds
+- Disable protection (the pause icon in the upper right corner)
+- Manually block an ad
+- Open the filtering log
+- Report incorrect blocking
+- Open AdGuard settings
+- View website certificate and manage HTTPS filtering (the lock icon next to the website name)
+
+## How to install
+
+When you install AdGuard for Mac, you will be prompted to install Browser Assistant for your default browser. If you skip this step, you can install it later.
+
+**From settings**:
+
+1. Open the AdGuard menu.
+1. Click the gear icon and select *Preferences*.
+1. Switch to the *Assistant* tab.
+1. Click *Get the Extension* next to your default browser.
+1. Install Assistant from your browser’s extension store.
+
+![The Assistant tab](https://cdn.adtidy.org/content/kb/ad_blocker/mac/assistant.png)
+
+**From the website**:
+
+1. Open the [Assistant page](https://adguard.com/adguard-assistant/overview.html).
+1. Under your browser name, select *Install*.
+1. Install Assistant from your browser’s extension store.
+
+:::note
+
+In rare cases, a browser may be incompatible with Assistant. To manage AdGuard from your browser, you can install the legacy Assistant instead.
+
+:::
+
+## Legacy Assistant
+
+The legacy Assistant is the previous version of AdGuard Browser Assistant. It’s a userscript that doesn’t require additional installation. While the legacy Assistant does its job well, it has several drawbacks:
+
+- It has fewer features than the extension version.
+- You have to wait for the userscript to be inserted into a webpage — sometimes it doesn’t load immediately.
+- You can’t hide the Assistant icon on the page.
+
+We recommend that you use the legacy Assistant only if the new Assistant is not available.

docs/adguard-for-mac/features/dns.md

@@ -0,0 +1,41 @@
+---
+title: DNS
+sidebar_position: 4
+---
+
+:::info
+
+This article covers AdGuard for Mac, a multifunctional ad blocker that protects your device at the system level. To see how it works, [download the AdGuard app](https://agrd.io/download-kb-adblock)
+
+:::
+
+## DNS protection
+
+The *DNS* section contains one feature, *DNS protection*, with multiple settings:
+
+- Providers
+- Filters
+- Blocklist
+- Allowlist
+
+![DNS](https://cdn.adtidy.org/content/kb/ad_blocker/mac/dns.png)
+
+If you enable *DNS protection*, DNS traffic will be managed by AdGuard.
+
+### Providers
+
+Under *Providers*, you can select a DNS server to encrypt your DNS traffic and block ads and trackers if necessary. We recommend AdGuard DNS. For more advanced configuration, you can [set up a private AdGuard DNS server](https://adguard-dns.io/welcome.html) or add a custom one by clicking the `+` icon in the lower left corner.
+
+### Filters
+
+DNS filters apply ad-blocking rules at the DNS level. Such filtering is less precise than regular ad blocking, but it’s particularly useful for blocking an entire domain. To add a DNS filter, click `+`. You can find more DNS filters at [filterlists.com](https://filterlists.com/).
+
+### Blocklist
+
+Domains from this list will be blocked. To add a domain, click `+`. You can add domain names or DNS filtering rules using a [special syntax](https://adguard-dns.io/kb/general/dns-filtering-syntax/).
+
+To export or import a blocklist, open the context menu.
+
+### Allowlist
+
+Domains from this list aren’t filtered. To add a domain, click `+`. To export or import an allowlist, open the context menu.

docs/adguard-for-mac/features/extensions.md

@@ -0,0 +1,33 @@
+---
+title: Extensions
+sidebar_position: 8
+---
+
+:::info
+
+This article covers AdGuard for Mac, a multifunctional ad blocker that protects your device at the system level. To see how it works, [download the AdGuard app](https://agrd.io/download-kb-adblock)
+
+:::
+
+AdGuard allows you to install extensions, or userscripts, to extend the functionality of the browser. AdGuard can work as a cross-browser userscript manager: you don’t have to install the same userscript for each browser.
+
+Some userscripts are pre-installed, others can be installed manually.
+
+![Extensions](https://cdn.adtidy.org/content/kb/ad_blocker/mac/extensions.png)
+
+## AdGuard Assistant (legacy)
+
+This userscript allows you to manage AdGuard protection directly from your browser. While the [new Assistant](/adguard-for-mac/features/browser-assistant) is a browser extension that can be installed from your browser’s store, the legacy Assistant is a userscript that doesn’t require additional installation. Some features are common to both assistants:
+
+- Enable or disable protection for a specific website
+- Pause protection for 30 seconds
+- Manually block an ad
+- Report incorrect blocking
+
+However, the new Assistant is more advanced. It also allows you to manage AdGuard protection for all websites, check the website’s certificate, manage HTTPS filtering, and open the filtering log or the app’s settings. We recommend that you use the legacy Assistant only if the new Assistant is not available.
+
+## AdGuard Extra
+
+This userscript solves the most complex ad blocking issues when regular rules aren’t enough. It also prevents websites from circumventing ad blockers and re-inserting blocked ads. We recommend that you keep it enabled at all times.
+
+To install a userscript, click `+`. You can find userscripts at [greasyfork.org](https://greasyfork.org/).

docs/adguard-for-mac/features/filters.md

@@ -0,0 +1,33 @@
+---
+title: Filters
+sidebar_position: 3
+---
+
+:::info
+
+This article covers AdGuard for Mac, a multifunctional ad blocker that protects your device at the system level. To see how it works, [download the AdGuard app](https://agrd.io/download-kb-adblock)
+
+:::
+
+## Filters
+
+![Filters](https://cdn.adtidy.org/content/kb/ad_blocker/mac/filters.png)
+
+Filter lists are sets of rules written using a [special syntax](/general/ad-filtering/create-own-filters). AdGuard interprets and implements these rules to block ads, trackers, and annoyances. Some filters (for example, AdGuard Base filter, Tracking Protection filter, or EasyList) are pre-installed, others can be installed additionally.
+
+We recommend enabling the following filters:
+
+- AdGuard Base filter
+- AdGuard Tracking Protection filter and AdGuard URL Tracking filter
+- AdGuard Annoyances filter
+- Filters for your language
+
+These filters are important for blocking most ads, trackers, and annoying elements. For more advanced ad blocking, you can use custom filters and user rules.
+
+To add a filter, click `+` in the lower left corner of the list. To enable a filter, select its checkbox.
+
+## User rules
+
+In AdGuard for Mac, user rules are located in *Filters*. To create a rule, click `+`. To enable a rule, select its checkbox. To export or import rules, open the context menu.
+
+![User rules: context menu](https://cdn.adtidy.org/content/kb/ad_blocker/mac/rules.png)

docs/adguard-for-mac/features/general.md

@@ -0,0 +1,40 @@
+---
+title: General
+sidebar_position: 2
+---
+
+:::info
+
+This article covers AdGuard for Mac, a multifunctional ad blocker that protects your device at the system level. To see how it works, [download the AdGuard app](https://agrd.io/download-kb-adblock)
+
+:::
+
+## How to open app settings
+
+To configure AdGuard for Mac, click the gear icon in the upper right corner of the main window and select *Preferences*.
+
+![Main window *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/mac/main.png)
+
+## General
+
+![General](https://cdn.adtidy.org/content/kb/ad_blocker/mac/general.png)
+
+### Do not block search ads and website self-promoting ads
+
+This feature prevents AdGuard from blocking [search ads and self-promotions on websites](/general/ad-filtering/search-ads). This can be useful, for example, when you’re shopping online and want to see discounts offered by some websites. Instead of adding these websites to the allowlist, you can exclude self-promotions and search ads from filtering.
+
+### Activate language-specific filters automatically
+
+This feature detects the language of the website you’re visiting and automatically activates appropriate filters for more accurate ad blocking. This is especially helpful if you change languages frequently.
+
+### Launch AdGuard at login
+
+This feature automatically launches AdGuard automatically after you restart your computer. This helps keep AdGuard protection active without having to manually open the app.
+
+### Hide menu bar icon
+
+This feature hides AdGuard’s icon from the menu bar but keeps AdGuard running in the background. If you want to disable AdGuard completely, click *Quit AdGuard* in the main window menu.
+
+### Allowlist
+
+Websites added to this list aren’t filtered. You can also access allowlisted websites from *User rules*.

docs/adguard-for-mac/features/main.md

@@ -0,0 +1,14 @@
+---
+title: Main window
+sidebar_position: 1
+---
+
+:::info
+
+This article covers AdGuard for Mac, a multifunctional ad blocker that protects your device at the system level. To see how it works, [download the AdGuard app](https://agrd.io/download-kb-adblock)
+
+:::
+
+The main window of AdGuard for Mac allows you to enable or disable the AdGuard protection. It also gives you a quick overview of the app’s stats: ads, trackers, and threats blocked since you’ve installed AdGuard or since your last stats reset. By clicking the gear icon, you can access settings, check for app and filter updates, contact support, and manage your license.
+
+![Main window *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/mac/main.png)

docs/adguard-for-mac/features/network.md

@@ -0,0 +1,36 @@
+---
+title: Network
+sidebar_position: 9
+---
+
+:::info
+
+This article covers AdGuard for Mac, a multifunctional ad blocker that protects your device at the system level. To see how it works, [download the AdGuard app](https://agrd.io/download-kb-adblock)
+
+:::
+
+## General
+
+![Network](https://cdn.adtidy.org/content/kb/ad_blocker/mac/network.png)
+
+### Automatically filter applications
+
+By default, AdGuard blocks ads and trackers in most browsers ([Tor Browser is an exception](/adguard-for-mac/solving-problems/tor-filtering)). This setting allows AdGuard to block ads in apps as well.
+
+To manage filtered apps, click *Applications*.
+
+### Filter HTTPS protocol
+
+This setting allows AdGuard to filter the secure HTTPS protocol, which is currently used by most websites and apps. By default, websites with potentially sensitive information, such as banking services, are not filtered. To manage HTTPS exclusions, click *Exclusions*.
+
+By default, AdGuard doesn’t filter websites with Extended Validation (EV) certificates. If needed, you can enable the *Filter websites with EV certificates* option.
+
+## Outbound proxy
+
+You can set up AdGuard to route all your device’s traffic through your proxy server.
+
+## HTTP proxy
+
+You can use AdGuard as an HTTP proxy server. This will allow you to filter traffic on other devices connected to the proxy.
+
+Make sure your Mac and your other device are connected to the same network and enter the proxy port on the device you want to route through your proxy server (usually in the network settings). To filter HTTPS traffic as well, [transfer AdGuard’s proxy certificate](http://local.adguard.org/cert) to this device. [Learn more about installing a proxy certificate](/guides/proxy-certificate)

docs/adguard-for-mac/features/security.md

@@ -0,0 +1,24 @@
+---
+title: Security
+sidebar_position: 6
+---
+
+:::info
+
+This article covers AdGuard for Mac, a multifunctional ad blocker that protects your device at the system level. To see how it works, [download the AdGuard app](https://agrd.io/download-kb-adblock)
+
+:::
+
+## Phishing and malware protection
+
+![Security](https://cdn.adtidy.org/content/kb/ad_blocker/mac/security.png)
+
+AdGuard has a database of fraudulent, phishing, and malicious domains. If you enable *Phishing and malware protection*, AdGuard will warn you every time you’re about to visit a dangerous website. Even if only some parts of the website are dangerous, AdGuard will check it and display a warning.
+
+This is safe. As AdGuard checks hash prefixes, not URLs, it doesn’t know what websites you visit. [Learn more about AdGuard’s security checks](/general/browsing-security)
+
+:::note
+
+AdGuard is not an antivirus software. It can’t stop you from downloading suspicious files or delete existing viruses.
+
+:::

docs/adguard-for-mac/features/stealth.md

@@ -0,0 +1,16 @@
+---
+title: Stealth Mode
+sidebar_position: 5
+---
+
+:::info
+
+This article covers AdGuard for Mac, a multifunctional ad blocker that protects your device at the system level. To see how it works, [download the AdGuard app](https://agrd.io/download-kb-adblock)
+
+:::
+
+## Advanced privacy protection
+
+![Stealth Mode](https://cdn.adtidy.org/content/kb/ad_blocker/mac/stealth.png)
+
+*Advanced privacy protection* protects your privacy by deleting cookies, UTM tags, online counters, and analytics systems. It doesn’t let websites collect your IP address, device and browser parameters, search queries, and personal information. [Learn more about Stealth Mode settings](/general/stealth-mode)