Merge branch 'master' of https://github.com/AdguardTeam/KnowledgeBaseVPN

 into add-videos

.github/workflows/markdown-lint.yml

@@ -0,0 +1,20 @@
+name: Lint Markdown
+
+on:
+  push
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - name: Use Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: 18.x
+
+      - name: yarn install
+        run: yarn install
+
+      - name: yarn lint:md
+        run: yarn lint:md

.markdownlint.json

@@ -0,0 +1,8 @@
+{
+    "ul-indent": { "indent": 4 },
+    "ul-style": { "style": "dash" },
+    "no-trailing-spaces": { "br_spaces": 0 },
+    "line-length": false,
+    "no-bare-urls": false,
+    "link-fragments": false
+}

.markdownlintignore

@@ -0,0 +1,2 @@
+node_modules/
+i18n/

README.md

@@ -27,11 +27,25 @@ Then you should open Terminal on your computer and navigate to the directory whe
 
 - `yarn install`
 
+### Lint markdown
+
+ This command lints the markdown and outputs any errors to the console:
+
+- `yarn lint:md`
+
+ Some of errors can be fixed automatically:
+
+- `yarn lint:md --fix`
+
+ VSCode users can install the [markdownlint extension][vscode-markdownlint] to see the errors in the
+
 ### How to run it locally
 
 - `yarn start`
 
-This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
+This command [lints markdown syntax](#lint-markdown),
+and if there is no markdownlint errors starts a local development server and opens up a browser window.
+Most changes are reflected live without having to restart the server.
 
 ## How to build it
 
@@ -47,3 +61,5 @@ Here's how you can debug translations locally.
 
 1. Download translations: `CROWDIN_PERSONAL_TOKEN="YOURTOKEN" yarn run crowdin download`
 2. Run Docusaurus with the language of your choice: `yarn run start -- --locale de`
+
+[vscode-markdownlint]: https://marketplace.visualstudio.com/items?itemName=DavidAnson.vscode-markdownlint

crowdin.yml

@@ -4,12 +4,12 @@ preserve_hierarchy: true
 
 # We generally want to use the "two-letters-code" of a locale (ie the language)
 # But not for all locales!
-# "pt-BR" may be better to remain as "pt-BR" instead of being transformed to "pt"
 # Note: &/* is Yaml anchor syntax: https://support.atlassian.com/bitbucket-cloud/docs/yaml-anchors/
 languages_mapping: &languages_mapping
   two_letters_code:
     zh-CN: zh-CN
     zh-TW: zh-TW
+    pt-BR: pt-BR
 
 files:
   - source: /i18n/en/**/*

docs/adguard-vpn-browser-extension/installation.md

@@ -35,4 +35,4 @@ Click the three dots icon in the top right corner of the browser, then select *E
 
 ### Opera
 
-Click the *Extensions* icon in the top right corner of the browser, then select *Manage extensions...*. Find AdGuard VPN in the list and click the *Remove* button.  
+Click the *Extensions* icon in the top right corner of the browser, then select *Manage extensions...*. Find AdGuard VPN in the list and click the *Remove* button.

docs/adguard-vpn-browser-extension/overview.md

@@ -9,8 +9,8 @@ AdGuard VPN Browser extension is available for Chrome, Firefox, Opera, and Edge.
 
 To manage your AdGuard VPN Browser extension:
 
-* Either click its icon on the browser's panel, click the hamburger menu icon, and select *Settings*,
-* Or go to the *Manage extensions* page in your browser, click *Details* below *AdGuard VPN* and manage its settings from there.
+- Either click its icon on the browser's panel, click the hamburger menu icon, and select *Settings*,
+- Or go to the *Manage extensions* page in your browser, click *Details* below *AdGuard VPN* and manage its settings from there.
 
 Once done, you'll see several tabs on the left:
 

docs/adguard-vpn-browser-extension/solving-problems/logs.md

@@ -7,71 +7,71 @@ There are several ways for collecting AdGuard VPN Browser extension logs, but wh
 
 ## Collecting and sending logs via the *Report a bug* section
 
-1.  Open AdGuard VPN Browser extension, if possible, repeat the actions that led to the error. Note the exact time when this error occurred.
-2.  Open *Settings* by clicking the hamburger menu icon (☰) → *Support* → *Report a bug*.
-3.  In the opened form, leave an automatically inserted email address or enter another one and describe the error found, including the time when this error occurred. If you can't reproduce the problem, specify as accurately as possible when it last occurred.
-4.  Make sure that there is a check mark next to *Include the diagnostic report in the message*, and tap *Submit*. This way, you will send logs along with the bug report.  
+1. Open AdGuard VPN Browser extension, if possible, repeat the actions that led to the error. Note the exact time when this error occurred.
+1. Open *Settings* by clicking the hamburger menu icon (☰) → *Support* → *Report a bug*.
+1. In the opened form, leave an automatically inserted email address or enter another one and describe the error found, including the time when this error occurred. If you can't reproduce the problem, specify as accurately as possible when it last occurred.
+1. Make sure that there is a check mark next to *Include the diagnostic report in the message*, and tap *Submit*. This way, you will send logs along with the bug report.
 
 ## Collecting and sending logs via the *Export logs* button
 
-1.  Open AdGuard VPN Browser extension, if possible, repeat the actions that led to the error. Note the exact time when this error occurred. 
-2.  Right-click the AdGuard VPN Browser extension icon. 
-3.  In the opened menu click *Export logs*.
-4.  As a result, the logs file will be saved to your device in `txt` format.
+1. Open AdGuard VPN Browser extension, if possible, repeat the actions that led to the error. Note the exact time when this error occurred.
+1. Right-click the AdGuard VPN Browser extension icon.
+1. In the opened menu click *Export logs*.
+1. As a result, the logs file will be saved to your device in `txt` format.
 
-Now that you have collected the logs, you need to hand them over to our development team. To do this: 
+Now that you have collected the logs, you need to hand them over to our development team. To do this:
 
-1.  Report a bug on GitHub. Detailed instructions on creating an issue on GitHub can be found in this article.  
-2.  Send an archive with logs and playback time to `[email protected]` and attach a link to your GitHub issue. Also you can add an archive with logs and playback time to Google Drive and share it with `[email protected]` attaching the Google Drive link to your issue on GitHub.
+1. Report a bug on GitHub. Detailed instructions on creating an issue on GitHub can be found in this article.
+1. Send an archive with logs and reproduce time to `[email protected]` and attach a link to your GitHub issue. Also you can add an archive with logs and reproduce time to Google Drive and share it with `[email protected]` attaching the Google Drive link to your issue on GitHub.
 
 ## Collecting and sending logs via browser developer's tools
 
 ### Chrome
 
-1.  Open AdGuard VPN Browser extension, if possible, repeat the actions that led to the error. Note the exact time when this error occurred. 
-2.  Go to `chrome://extensions`
-3.  Turn on *developer mode*
+1. Open AdGuard VPN Browser extension, if possible, repeat the actions that led to the error. Note the exact time when this error occurred.
+1. Go to `chrome://extensions`
+1. Turn on *developer mode*
 
     ![The developer mode *border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/dev_mode.png)
 
-4.  Click `background.html`
+1. Click `background.html`
 
     ![Background *border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/backgroung.png)
 
-5.  Open the *Console tab*
+1. Open the *Console tab*
 
     ![The Console tab *border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/console.png)
 
-6.  Open the context menu and click *Save as…*
+1. Open the context menu and click *Save as…*
 
     ![Save as *border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save.png)
 
-Now that you have collected the logs, you need to hand them over to our development team. To do this: 
+Now that you have collected the logs, you need to hand them over to our development team. To do this:
 
-1.  Report a bug on GitHub. Detailed instructions on creating an issue on GitHub can be found in this article. 
-2.  Send an archive with logs and playback time to `[email protected]` and attach a link to your GitHub issue. Also you can add an archive with logs and playback time to Google Drive and share it with `[email protected]` attaching the Google Drive link to your issue on GitHub.
+1. Report a bug on GitHub. Detailed instructions on creating an issue on GitHub can be found in this article.
+1. Send an archive with logs and playback time to `[email protected]` and attach a link to your GitHub issue. Also you can add an archive with logs and playback time to Google Drive and share it with `[email protected]` attaching the Google Drive link to your issue on GitHub.
 
 ### Firefox
 
-1.  Open AdGuard VPN Browser extension, if possible, repeat the actions that led to the error. Note the exact time when this error occurred. 
-2.  Go to `about:addons`
-3.  Click *Debug Add-ons*
+1. Open AdGuard VPN Browser extension, if possible, repeat the actions that led to the error. Note the exact time when this error occurred.
+1. Go to `about:addons`
+1. Click *Debug Add-ons*
 
     ![Debug Add-ons *border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/add-ons.png)
 
-4.  Click *Inspect*
+1. Click *Inspect*
 
     ![Inspect *border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/inspect.png)
 
-5.  Go to the *Console* tab
+1. Go to the *Console* tab
 
     ![Console *border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/ff_console.png)
 
-6.  Click *Save all Messages to file*
+1. Click *Save all Messages to file*
 
     ![Save *border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save-to-file.png)
 
-Now that you have collected the logs, you need to hand them over to our development team. To do this: 
+Now that you have collected the logs, you need to hand them over to our development team. To do this:
 
-1.  Report a bug on GitHub. Detailed instructions on creating an issue on GitHub can be found in this article. 
-2.  Send an archive with logs and playback time to `[email protected]` and attach a link to your GitHub issue. Also you can add an archive with logs and playback time to Google Drive and share it with `[email protected]` attaching the Google Drive link to your issue on GitHub.
+1. Report a bug on GitHub. Detailed instructions on creating an issue on GitHub can be found in this article.
+1. Send an archive with logs and playback time to `[email protected]` and attach a link to your GitHub issue. Also you can add an archive with logs and playback time to Google Drive and share it with `[email protected]` attaching the Google Drive link to your issue on GitHub.

docs/adguard-vpn-for-android/installation.md

@@ -14,7 +14,7 @@ You can find the AdGuard VPN for Android app in *Google Play* and install it for
 
 2. Next, in the search bar, start typing *"AdGuard"* and select *"adguard vpn"* from the list of suggested options.
 
-3. Select *AdGuard VPN - private proxy* from the list of suggested applications and tap *Install*. 
+3. Select *AdGuard VPN - private proxy* from the list of suggested applications and tap *Install*.
 
 4. Wait for the installation to finish and tap *Open*.
 
@@ -24,4 +24,4 @@ AdGuard VPN for Android has been successfully installed!
 
 If you decided to delete AdGuard VPN for Android, find the icon of this app and hold it. In the opened list, tap *Uninstall*.
 
-You can learn more about the AdGuard VPN for Android in [this article](overview.md).
+You can learn more about the AdGuard VPN for Android in [this article](overview.md)

docs/adguard-vpn-for-android/overview.md

@@ -9,9 +9,9 @@ A VPN is an ideal tool that provides security and anonymity each time you browse
 
 **VPN is frequently used for:**
 
-* Keeping personal data safe even while using public Wi-Fi
-* Preventing online activity tracking by masking the IP address
-* Hiding the real geolocation to remain anonymous
+- Keeping personal data safe even while using public Wi-Fi
+- Preventing online activity tracking by masking the IP address
+- Hiding the real geolocation to remain anonymous
 
 AdGuard VPN for Android can do it all for you — and even offer something unique. To find out why AdGuard VPN is the better option — read [this article](/general/why-adguard-vpn.md).
 
@@ -43,7 +43,7 @@ You can add domains (e.g. `google.com`) or subdomains (e.g. `*.google.com`) of w
 
 As you can enable subdomains in service lists, we added boxes that reflect the status of each service — you can see them on the main screen of *Exclusions* to the left of each service name: **fully-enabled** status is marked with a white check mark on green background, **fully-disabled** — with a gray box, and **partly-enabled**, which means that one or more parameters were changed — with a green square on white background. Good news: you can always return to the default view of service lists in case you’ve deleted or disabled any domains from there.
 
-![Exclusions](https://cdn.adguardvpn.com/content/kb/vpn/android/statuses.png)
+![Exclusions *mobile_border](https://cdn.adguardvpn.com/content/kb/vpn/android/statuses.png)
 
 Another useful feature is *Import/Export exclusions*. There are only four steps to reach the goal:
 
@@ -52,21 +52,21 @@ Another useful feature is *Import/Export exclusions*. There are only four steps
 3. When transferring between different devices, don't forget to send the `.zip` file to the device for import. For example, if you import exclusion lists from your Windows device to your Android, make sure to send the `.zip` file to your Android beforehand.
 4. Open AdGuard VPN on the device where you want to import the archive with the ready lists of exclusions. Find the appropriate section, click the *Import* button and select the archive.
 
-![Import/Export](https://cdn.adguardvpn.com/content/kb/vpn/android/imp-exp.png)
+![Import/Export *mobile_border](https://cdn.adguardvpn.com/content/kb/vpn/android/imp-exp.png)
 
 ### Apps Settings
 
 As we mentioned above, not only websites can be easily added to the exclusions. Choose for which applications you need AdGuard VPN and for which you don't. Tap the icon next to the *Exclusions lists* icon at the bottom of the screen, to open Apps settings. By default, AdGuard VPN works with all apps, but you can toggle the slider next to any app in the list — and disable AdGuard VPN for it.
 
 If the *Compatibility mode* with AdGuard is enabled, you can only manage apps through the AdGuard Ad Blocker. Therefore, when you tap the button, the AdGuard app opens.
 
-![Apps settings](https://cdn.adguardvpn.com/content/kb/vpn/android/apps_settings.png)
+![Apps settings *mobile_border](https://cdn.adguardvpn.com/content/kb/vpn/android/apps_settings.png)
 
 ## Settings
 
 You can reach *Settings* by pressing the gear icon at the bottom right of the screen. The first section there is *App Settings*: configure AdGuard VPN for Android as you need by selecting different options there.
 
-![Apps settings](https://cdn.adguardvpn.com/content/kb/vpn/android/app_settings.png)
+![Apps settings *mobile_border](https://cdn.adguardvpn.com/content/kb/vpn/android/app_settings.png)
 
 ### AdGuard VPN autostart
 
@@ -90,7 +90,7 @@ Note that if Kill Switch is on, *Apps settings* and *Exclusions* won’t work.
 
 You can choose the system default, dark or light theme of the app.
 
-![Theme](https://cdn.adguardvpn.com/content/kb/vpn/android/theme-light-dark.png)
+![Theme *mobile_border](https://cdn.adguardvpn.com/content/kb/vpn/android/theme-light-dark.png)
 
 ### Advanced settings
 

docs/adguard-vpn-for-android/solving-problems/chromecast.md

@@ -3,8 +3,8 @@ title: 'Compatibility of AdGuard VPN with Chromecast'
 sidebar_position: 5
 ---
 
-The built-in Chromecast technology is incompatible with running a VPN because it uses the [DLNA protocol](https://en.wikipedia.org/wiki/Digital_Living_Network_Alliance) which does not support VPN connections. This means that if a Chromecast device and a smartphone or tablet running a VPN are on the same Wi-Fi network, in most cases Chromecast won't be recognised by the mobile device.
+The built-in Chromecast technology is incompatible with running a VPN because it uses the [DLNA protocol](https://en.wikipedia.org/wiki/Digital_Living_Network_Alliance) which does not support VPN connections. This means that if a Chromecast device and a smartphone or tablet running a VPN are on the same Wi-Fi network, in most cases Chromecast won't be recognized by the mobile device.
 
 Google has also blocked the ability to change the Chromecast's network settings by restricting access to its DNS settings. This also prevents Chromecast from working with a VPN.
 
-You can solve the problem by setting up a VPN on a router. This will allow all devices connected to the router to use the VPN connection, including Chromecast. But remember: setting up a VPN on your router may require additional knowledge, so read the manufacturer's manual.
+You can solve the problem by setting up a VPN on a router. This will allow all devices connected to the router to use the VPN connection, including Chromecast. But remember: setting up a VPN on your router may require additional knowledge, so read the manufacturer's manual.

docs/adguard-vpn-for-android/solving-problems/integrated-mode.md

@@ -3,11 +3,10 @@ title: Compatibility with AdGuard Ad Blocker
 sidebar_position: 3
 ---
 
-
 AdGuard VPN has the VPN operating mode enabled by default, which uses its own [AdGuard VPN protocol](/general/adguard-vpn-protocol.mdx). It provides the best combination of connection speed and security. However, this operating mode does not allow AdGuard VPN and AdGuard Ad Blocker to work simultaneously. The Compatibility mode, in turn, uses the IPsec protocol, which makes it possible for the AdGuard applications to work together. If you already have AdGuard Ad Blocker when installing AdGuard VPN, this mode will turn on automatically and allow you to use our applications at the same time. If you first installed AdGuard VPN, and only then decided to try AdGuard Ad Blocker, then to use them together, follow these steps:
 
 1. Open AdGuard VPN for Android and select the gear icon at the bottom right of the screen.
 
 2. Go to "Advanced settings" and select "Operating mode".
 
-3. Switch the mode from to *Compatibility mode with AdGuard*. Done!
+3. Switch the mode from to *Compatibility mode with AdGuard*. Done!