[AGM-2402] Update AdGuard for Linux

docs/adguard-for-linux/installation.md

@@ -5,19 +5,27 @@ sidebar_position: 2
 
 ## Install AdGuard for Linux
 
+Open the command line on your computer. On Linux, use the keyboard shortcut “Ctrl+Alt+T”. On Mac, type “Terminal” in the search field.
+
 To install AdGuard, enter:
 
 Release
 
-    curl -fsSL https://raw.githubusercontent.com/AdguardTeam/AdGuardCLI/release/install.sh | sh -s -- -v
+```sh
+curl -fsSL https://raw.githubusercontent.com/AdguardTeam/AdGuardCLI/release/install.sh | sh -s -- -v
+```
 
 Beta
 
-    curl -fsSL https://raw.githubusercontent.com/AdguardTeam/AdGuardCLI/beta/install.sh | sh -s -- -v
+```sh
+curl -fsSL https://raw.githubusercontent.com/AdguardTeam/AdGuardCLI/beta/install.sh | sh -s -- -v
+```
 
 Nightly
 
-    curl -fsSL https://raw.githubusercontent.com/AdguardTeam/AdGuardCLI/nightly/install.sh | sh -s -- -v
+```sh
+curl -fsSL https://raw.githubusercontent.com/AdguardTeam/AdGuardCLI/nightly/install.sh | sh -s -- -v
+```
 
 If required, enter your admin password.
 
@@ -29,44 +37,118 @@ You can verify the signature to prove it’s an official version of AdGuard by u
 
 :::
 
-## Activate license
+## Initial setup
 
-AdGuard for Linux requires an [AdGuard license](https://adguard.com/license.html). If you don't have a license yet, you can log in or create an account to get a free 14-day trial. If you already have a license, log in to activate it.
+AdGuard for Linux requires an [AdGuard license](https://adguard.com/license.html). If you don’t have a license yet, you can log in or create an account to get a free 14-day trial. If you already have a license, log in to activate it. To do it, follow this step-by-step guide:
 
-To log in or create an account, enter:
+1. After installation, enter:
 
+    ```sh
     adguard-cli activate
+    ```
+
+1. Then select the desired option:
+
+    ![adguard-cli activate *border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/activation1.png)
+
+1. Once you have a license, follow the provided link to proceed with the activation:
+
+    ![Activate license *border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/activation2.png)
+
+1. After activation, you can continue to work with the program:
+
+    ![Successful activation *border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/activation3.png)
 
-To reset your license, enter:
+1. You can also reset your license by entering:
 
+    ```sh
     adguard-cli reset-license
+    ```
 
-To view the license info, enter:
+    or  view the license info by entering
 
+    ```sh
     adguard-cli license
+    ```
 
-## Initial setup
+1. Now you need to set up AdGuard CLI. To run the configuration wizard, enter:
+
+    ```sh
+    adguard-cli configure
+    ```
 
-To get AdGuard up and running, complete the initial setup. This includes installing the AdGuard CA certificate, enabling the necessary filters, and selecting the proxy mode.
+    ![Setup *border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/activation4.png)
 
-To run the configuration wizard, enter:
+    The wizard will ask basic questions required for the initial setup.
 
-    adguard-cli configure
+1. After that, you can start the AdGuard protection by entering
+
+    ```sh
+    adguard-cli start
+    ```
+
+    ![Start protecton *border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/activation5.png)
+
+    1. You can check the protection status using:
+
+    ```sh
+    adguard-cli status
+    ```
+
+    and stop it with:
+
+    ```sh
+    adguard-cli stop
+    ```
+
+    ![Stop protecton *border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/activation6.png)
+
+1. To check the current configuration, enter:
+
+    ```sh
+    adguard-cli config show
+    ```
+
+    ![Current setup *border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/activation7.png)
+
+    The path to the configuration file will also be displayed, which you can and should edit directly. It contains descriptions of all additional options.
+
+    As an alternative, you can use the commands:
+
+    ```sh
+    adguard-cli config get
+    ```
+
+    or:
+
+    ```sh
+    adguard-cli config set
+    ```
+
+    They are primarily intended for scripting, though.
+
+For further information on the available commands, check out the section [Settings and protection management](https://adguard.com/kb/adguard-for-linux/settings/).
 
 ## Uninstall AdGuard for Linux
 
 To uninstall AdGuard, enter:
 
 Release
 
-    curl -fsSL https://raw.githubusercontent.com/AdguardTeam/AdGuardCLI/release/install.sh | sh -s -- -v -u
+```sh
+curl -fsSL https://raw.githubusercontent.com/AdguardTeam/AdGuardCLI/release/install.sh | sh -s -- -v -u
+```
 
 Beta
 
-    curl -fsSL https://raw.githubusercontent.com/AdguardTeam/AdGuardCLI/beta/install.sh | sh -s -- -v -u
+```sh
+curl -fsSL https://raw.githubusercontent.com/AdguardTeam/AdGuardCLI/beta/install.sh | sh -s -- -v -u
+```
 
 Nightly
 
-    curl -fsSL https://raw.githubusercontent.com/AdguardTeam/AdGuardCLI/nightly/install.sh | sh -s -- -v -u
+```sh
+curl -fsSL https://raw.githubusercontent.com/AdguardTeam/AdGuardCLI/nightly/install.sh | sh -s -- -v -u
+```
 
 If required, enter your admin password.

docs/adguard-for-linux/settings.md

@@ -3,43 +3,82 @@ title: Settings and protection management
 sidebar_position: 3
 ---
 
+## Available commands
+
 To get a list of all available AdGuard commands, enter:
 
-    adguard-cli --help-all
+```sh
+adguard-cli --help-all
+```
 
 ## Enable and disable protection
 
+### Enable protection
+
 To enable protection, enter:
 
-    adguard-cli start
+```sh
+adguard-cli start
+```
+
+This command attempts to configure a redirection to the proxy.
+
+![Start protection *border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/start-protection.gif)
+
+### Disable protection
 
 To disable protection, enter:
 
-    adguard-cli stop
+```sh
+adguard-cli stop
+```
+
+This command not only stops the proxy but also stops the trafic from redirecting to it.
+
+### Check protection status
 
 To view the protection status, enter:
 
-    adguard-cli status
+```sh
+adguard-cli status
+```
+
+![Status/Stop protection *border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/activation6.png)
+
+## Updates
 
-## Check for updates
+### Check for updates
 
 To check for updates, enter:
 
-    adguard-cli check-update
+```sh
+adguard-cli check-update
+```
+
+### Update AdGuard for Linux
 
 To update AdGuard for Linux, enter:
 
-    adguard-cli update
+```sh
+adguard-cli update
+```
+
+### Update script output
 
 To view the update script output, enter:
 
-    adguard-cli update -v
+```sh
+adguard-cli update -v
+```
 
 ## Configure AdGuard for Linux
 
 Use the `config` command to configure AdGuard for Linux. Subcommands:
 
 - `show`: Show the current configuration in `proxy.yaml`
+
+    ![Current setup *border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/activation7.png)
+
 - `set`: Configure an option in `proxy.yaml`
     - `listen_ports.http_proxy`: HTTP listening port
     - `proxy_mode`: Proxy mode (`manual` or `auto`)
@@ -51,7 +90,13 @@ Use the `filters` command to configure AdGuard for Linux. Subcommands:
 
 - `list`: List installed filters
     - `--all`: View all filters
+
+    ![Filter list *border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/filter-list.png)
+
 - `install`: Install a filter. Enter the URL of the filter you want to install
 - `enable`: Enable a filter. Enter the name or ID of the filter
+
+    ![Enable filters *border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/built-in-filters.png)
+
 - `disable`: Disable a filter. Enter the name or ID of the filter
 - `update`: Update filters