From 7e185f41158ea0d975fd744459fcac23b94cc607 Mon Sep 17 00:00:00 2001 From: Helen <58733007+el-termikael@users.noreply.github.com> Date: Tue, 1 Aug 2023 17:37:37 +0300 Subject: [PATCH 01/11] fixed formatting violations fixes included: - emphasis used instead of a heading - files should end with a single newline character - headings should be surrounded by blank lines - lists should be surrounded by blank lines - multiple consecutive blank lines - multiple spaces after block quote symbol - ordered list item prefix - trailing spaces --- docs/adguard-vpn-for-android/installation.md | 4 ++-- .../solving-problems/integrated-mode.md | 3 +-- .../solving-problems/restricted-mode.md | 9 ++++++-- docs/adguard-vpn-for-ios/installation.md | 5 +---- docs/adguard-vpn-for-ios/overview.md | 1 + .../solving-problems/automation.md | 16 +++++++------- .../solving-problems/integrated-mode.md | 6 ++--- docs/adguard-vpn-for-mac/installation.md | 22 ++----------------- docs/adguard-vpn-for-mac/overview.md | 2 ++ .../solving-problems/logs.md | 2 +- docs/adguard-vpn-for-windows/overview.md | 8 +++---- .../solving-problems/logs.md | 2 -- docs/general/adguard-vpn-encryption.md | 4 ++-- docs/general/free-vs-unlimited.md | 20 ++++++++--------- docs/general/how-to-install.md | 2 +- docs/general/how-vpn-works.md | 8 +++---- docs/general/subscription.md | 2 +- docs/general/why-adguard-vpn.md | 9 ++++++++ docs/intro.md | 4 ++++ docs/miscellaneous/acknowledgements.md | 12 ++++------ docs/miscellaneous/take-screenshot.md | 20 ++++++++--------- 21 files changed, 76 insertions(+), 85 deletions(-) diff --git a/docs/adguard-vpn-for-android/installation.md b/docs/adguard-vpn-for-android/installation.md index 3ac602c5d..568ff9c8b 100644 --- a/docs/adguard-vpn-for-android/installation.md +++ b/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). \ No newline at end of file +You can learn more about the AdGuard VPN for Android in [this article](overview.md) diff --git a/docs/adguard-vpn-for-android/solving-problems/integrated-mode.md b/docs/adguard-vpn-for-android/solving-problems/integrated-mode.md index fb191cc76..4078d6287 100644 --- a/docs/adguard-vpn-for-android/solving-problems/integrated-mode.md +++ b/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! \ No newline at end of file +3. Switch the mode from to *Compatibility mode with AdGuard*. Done! diff --git a/docs/adguard-vpn-for-android/solving-problems/restricted-mode.md b/docs/adguard-vpn-for-android/solving-problems/restricted-mode.md index c3b2c1040..eae8bae15 100644 --- a/docs/adguard-vpn-for-android/solving-problems/restricted-mode.md +++ b/docs/adguard-vpn-for-android/solving-problems/restricted-mode.md @@ -12,27 +12,32 @@ You have two ways to solve the issue: ### Option 1: Grant permissions to AdGuard VPN using ADB 1. Activate the **developer mode** and enable **USB debugging**: + - Open the **Settings** application on your phone; - Go to **System** section (last item in the settings menu). In this section find sub-item **About phone**; - Click the **Build number** line 7 times. After that, you will receive a notification that **You are now a developer** (If necessary, enter an unlock code for the device); - Open **System Settings** → **Developer Options** → Scroll down and enable **USB debugging** → Confirm debugging is enabled in the window **Allow USB debugging** after reading the warning carefully. -> If you have any difficulties or additional questions, full instructions can be found [here](https://developer.android.com/studio/debug/dev-options). +> If you have any difficulties or additional questions, full instructions can be found [here](https://developer.android.com/studio/debug/dev-options). 2. [Install and configure](https://www.xda-developers.com/install-adb-windows-macos-linux/) ADB; + > On the Windows platform, **Samsung** owners may need to install [this utility](https://developer.samsung.com/mobile/android-usb-driver.html). 3. Connect your device using a **USB cable** to the computer or laptop on which you installed **ADB**; + 4. Open **the command line** on your PC: + - **Cmd.exe** if you are using **Windows**; - **Terminal** if you are using **macOS**; + 5. Enter the command `adb shell pm grant com.adguard.vpn android.permission.INTERACT_ACROSS_USERS` and press **Enter**. ### Option 2: Remove *Restricted user account* You can [find here](https://support.google.com/a/answer/6223444?hl=en) how to manage user accounts from an Android device. -> Please note, that in some cases restricted user accounts are created implicitly and cannot be removed. For instance, when you use Dual Messenger or Dual App features on **Samsung** or **LG** devices. Read below how to fix the issue in these cases. +> Please note that in some cases restricted user accounts are created implicitly and cannot be removed. For instance, when you use Dual Messenger or Dual App features on **Samsung** or **LG** devices. Read below how to fix the issue in these cases. ### LG and Samsung devices diff --git a/docs/adguard-vpn-for-ios/installation.md b/docs/adguard-vpn-for-ios/installation.md index 70b53b52c..d7594cb07 100644 --- a/docs/adguard-vpn-for-ios/installation.md +++ b/docs/adguard-vpn-for-ios/installation.md @@ -14,15 +14,12 @@ You can download and install the *AdGuard VPN for iOS* app for free in the *App 1. Open the *App Store* app on your device and tap *Search* in the bottom right corner of the screen. ![App Store](https://cdn.adguardvpn.com/content/kb/vpn/ios/app-store-en.png) - 2. Next, in the search bar, start typing *"AdGuard"* and select *"adguard vpn"* from the list of suggested options. ![Search](https://cdn.adguardvpn.com/content/kb/vpn/ios/search-en.png) - 3. Select *AdGuard VPN - Unlimited & Fast* from the list of suggested applications and tap *Download*. If necessary, enter your Apple ID account password in the opened window. ![AdGuard VPN](https://cdn.adguardvpn.com/content/kb/vpn/ios/adguard-vpn-en.png) - 4. Wait for the download to finish and tap *Open*. AdGuard VPN for iOS has been successfully installed! @@ -33,4 +30,4 @@ If you decided to delete AdGuard VPN for iOS, find the icon of this app on the H ![Uninstall](https://cdn.adguardvpn.com/public/Adguard/kb/vpn-install/deinstall-en.png) -You can learn more about the AdGuard VPN app for iOS in [this article](overview.md). \ No newline at end of file +You can learn more about the AdGuard VPN app for iOS in [this article](overview.md). diff --git a/docs/adguard-vpn-for-ios/overview.md b/docs/adguard-vpn-for-ios/overview.md index 0a58a5474..38328d3d0 100644 --- a/docs/adguard-vpn-for-ios/overview.md +++ b/docs/adguard-vpn-for-ios/overview.md @@ -8,6 +8,7 @@ sidebar_position: 1 A VPN allows you to create a secure connection to another network on the Internet. It connects a user's computer or mobile device to a server and allows one to browse the net using someone else's IP address. So if the VPN server is located in a different country, it will appear that you have connected to the Internet from that country. [Learn more](/general/how-vpn-works.md) about how a VPN works in detail. Speaking of AdGuard VPN, it has several functions: + * hides your real whereabouts and helps you stay anonymous * сhanges your IP address to protect your data from tracking * encrypts your traffic to make it unreachable to scammers diff --git a/docs/adguard-vpn-for-ios/solving-problems/automation.md b/docs/adguard-vpn-for-ios/solving-problems/automation.md index 25addfa2a..59af12813 100644 --- a/docs/adguard-vpn-for-ios/solving-problems/automation.md +++ b/docs/adguard-vpn-for-ios/solving-problems/automation.md @@ -4,18 +4,19 @@ sidebar_position: 1 sidebar_label: How to set up AdGuard VPN automation --- -AdGuard VPN has an *Exclusions* section and two operation modes – *General* and *Selective*. In *General mode* AdGuard VPN works everywhere except sites added to exclusions. Conversely, in *Selective mode*, VPN doesn't work anywhere except sites listed in the exclusions list. Note, that for each mode you must create a separate list. +AdGuard VPN has an *Exclusions* section and two operation modes – *General* and *Selective*. In *General mode* AdGuard VPN works everywhere except sites added to exclusions. Conversely, in *Selective mode*, VPN doesn't work anywhere except sites listed in the exclusions list. Note, that for each mode you must create a separate list. As you may notice, only websites can be added to the *Exclusions* section. To adjust AdGuard VPN for apps you need to use another feature. Our desktop apps have the *Split tunneling* module and the app for Android has *Apps settings* — these settings allow you to decide in which apps AdGuard VPN should run. -But, as it often happens, due to a number of technical nuances, it is impossible to implement such a useful function for iOS, at least for now. Therefore, we offer you an alternative way to automate AdGuard VPN for apps on iPhones and iPads. +But, as it often happens, due to a number of technical nuances, it is impossible to implement such a useful function for iOS, at least for now. Therefore, we offer you an alternative way to automate AdGuard VPN for apps on iPhones and iPads. ## Setting up AdGuard VPN automatic activation -If you need a VPN for one or more apps, set up AdGuard VPN to automatically turn on and off when you open and close them. Go to the Exclusions tab, select General mode and follow the instructions. Here we describe how to create automation for Twitter, but you can choose any other app. +If you need a VPN for one or more apps, set up AdGuard VPN to automatically turn on and off when you open and close them. Go to the Exclusions tab, select General mode and follow the instructions. Here we describe how to create automation for Twitter, but you can choose any other app. ![Instruction. Part 1](https://cdn.adguardvpn.com/public/Adguard/Blog/VPNauto/vpn_on1_en.jpg) -1. Download [the *Shortcuts* app](https://apps.apple.com/us/app/shortcuts/id915249334) from the App Store and go to the *Automation* section by tapping the clock icon at the bottom of the screen. + +1. Download [the *Shortcuts* app](https://apps.apple.com/us/app/shortcuts/id915249334) from the App Store and go to the *Automation* section by tapping the clock icon at the bottom of the screen. 2. Tap the *Create Personal Automation* button, then find *App* in the list that opens and tap it. 3. In the next window, make sure that the *Is Opened* option is selected, and then tap *Choose* to choose the app. @@ -23,11 +24,10 @@ If you need a VPN for one or more apps, set up AdGuard VPN to automatically turn 4. Start entering the name of the application, in our case it's Twitter, and select it. Then tap *Done* in the upper right corner of the screen. After it tap *Next* in the upper right corner of the screen. And in the opened window tap *Add Action*. ![Instruction. Part 3](https://cdn.adguardvpn.com/public/Adguard/Blog/VPNauto/vpn_on3_en.jpg) - 5. Start entering “AdGuard VPN” and select the AdGuard VPN app. In the new window tap *Set a VPN connection*. ![Instruction. Part 4](https://cdn.adguardvpn.com/public/Adguard/Blog/VPNauto/vpn_on4_en.jpg) -6. Make sure the variables say *Turn* VPN connection *On* and tap *Next*. +6. Make sure the variables say *Turn* VPN connection *On* and tap *Next*. 7. In the next window, move the slider next to the *Ask before running* option to the inactive position. Confirm your choice, the tap *Done*. Now you have a new scenario: AdGuard VPN will be automatically enabled when you start the Twitter app. Now you need to create another command that will make AdGuard VPN automatically turn off when you close the app. @@ -35,6 +35,7 @@ Now you have a new scenario: AdGuard VPN will be automatically enabled when you ## Configuring AdGuard VPN automatic shutdown ![Instruction. Part 1](https://cdn.adguardvpn.com/public/Adguard/Blog/VPNauto/vpn_off1_en.jpg) + 1. In the same *Shortcuts* app start creating a new automation: click *+* in the upper right corner of the screen and then on the *Create Personal Automation* button. In the opened window choose *App*. 2. Make sure that the *Is Closed* option is selected and uncheck the box under the adjacent option. Then tap *Choose*. @@ -42,9 +43,8 @@ Now you have a new scenario: AdGuard VPN will be automatically enabled when you 3. Start entering *Twitter* and select the app. Then tap *Done* in the upper right corner of the screen. Tap *Add Action* and select AdGuard VPN. ![Instruction. Part 3](https://cdn.adguardvpn.com/public/Adguard/Blog/VPNauto/vpn_off3_en.jpg) - 4. In the new window tap *Set VPN connection*. 5. Then tap the word *On* so that it changes to the word *Off*, then tap *Next* in the upper right corner of the screen. 6. Disable the *Ask before running* option and confirm your selection. Then tap *Done* at the top right corner of the screen to complete the process. -Done! AdGuard VPN will now be enabled on your device every time you open the Twitter app, and disabled when you close it. You can repeat the same steps for any other app. \ No newline at end of file +Done! AdGuard VPN will now be enabled on your device every time you open the Twitter app, and disabled when you close it. You can repeat the same steps for any other app. diff --git a/docs/adguard-vpn-for-ios/solving-problems/integrated-mode.md b/docs/adguard-vpn-for-ios/solving-problems/integrated-mode.md index caf4ad688..4488424f3 100644 --- a/docs/adguard-vpn-for-ios/solving-problems/integrated-mode.md +++ b/docs/adguard-vpn-for-ios/solving-problems/integrated-mode.md @@ -3,9 +3,9 @@ title: Compatibility with AdGuard Ad Blocker sidebar_position: 3 --- -AdGuard VPN has two operating modes — General and Integrated one. General mode is enabled by default and uses [AdGuard VPN protocol](/general/adguard-vpn-protocol.mdx). It provides the best combination of connection speed and security. +AdGuard VPN has two operating modes — General and Integrated one. General mode is enabled by default and uses [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. +However, this operating mode does not allow AdGuard VPN and AdGuard Ad Blocker to work simultaneously. In Integrated mode, in turn, the IPsec protocol is used, 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 installed AdGuard VPN first and only then decided to try AdGuard Ad Blocker, follow these steps to use two apps together: @@ -15,4 +15,4 @@ In Integrated mode, in turn, the IPsec protocol is used, which makes it possible 3. Switch the mode from *General* to *Integrated*. Done! -> Note that in **Integrated** mode you can't use the Exclusions feature or the DNS server feature. \ No newline at end of file +> Note that in **Integrated** mode you can't use the Exclusions feature or the DNS server feature. diff --git a/docs/adguard-vpn-for-mac/installation.md b/docs/adguard-vpn-for-mac/installation.md index 771a1ab74..d1b06fd93 100644 --- a/docs/adguard-vpn-for-mac/installation.md +++ b/docs/adguard-vpn-for-mac/installation.md @@ -11,33 +11,23 @@ sidebar_position: 2 **Free disk space**: 120 Mb - ## How to install AdGuard VPN for Mac 1. To install AdGuard VPN for Mac, just follow [this link](https://agrd.io/mac_vpn) or open a browser, type *adguard-vpn.com* in the address bar and on the opened page click *Download*. - ![Download AdGuard VPN from the official website](https://cdn.adguardvpn.com/public/Adguard/kb/vpn-install/mac-install-en.png) - 2. Wait until the download of the *AdGuardVPN.dmg* file is finished and open it in the "Downloads" folder. - 3. Wait until the installation program window opens. Double-click the icon in it. - ![Program installation window](https://cdn.adguardvpn.com/public/Adguard/kb/vpn-install/mac-install-ru-1.png) - 4. When you first start AdGuard VPN, the operating system will show a warning on the screen that this application has been downloaded from the Internet. Click *Open*. - 5. Then click *Continue* and *Install*. - ![Click Continue](https://cdn.adguardvpn.com/public/Adguard/kb/vpn-install/mac-install-2-en.png) -![click Install](https://cdn.adguardvpn.com/public/Adguard/kb/vpn-install/mac-install-3-en.png) - +![Click Install](https://cdn.adguardvpn.com/public/Adguard/kb/vpn-install/mac-install-3-en.png) 6. Wait for the installer to download the necessary files. AdGuard VPN for Mac is installed! - -## How to uninstall AdGuard VPN for Mac? +## How to uninstall AdGuard VPN for Mac ### Standard uninstallation @@ -49,25 +39,17 @@ To uninstall AdGuard VPN for Mac, follow two simple steps: ![Standard uninstallation](https://cdn.adguardvpn.com/public/Adguard/kb/vpn-install/mac-uninstall-1-en.png) - ### Advanced uninstallation Sometimes, as a result of incorrect removal, or in other rare cases, the standard uninstallation may not be enough. Then the support service may ask you to do an advanced uninstallation in order to completely remove AdGuard VPN from your Mac. To do this, do the following: 1. Follow the steps described in the section ["Standard uninstallation"](#how-to-uninstall-adguard-vpn-for-mac). - 2. Open "Finder" or "Spotlight" and enter `Keychain` in the search. - ![Advanced uninstallation. Enter Keychain](https://cdn.adguardvpn.com/public/Adguard/kb/vpn-install/mac-key-chain-en.png) - 3. Click the icon of the found program and enter `com.adguard.mac.vpn` in the search. If there is such a record in the search results, delete it. - 4. Go back to "Finder" or "Spotlight" and enter `Terminal`. - ![Advanced uninstallation. Enter Terminal](https://cdn.adguardvpn.com/public/Adguard/kb/vpn-install/mac-terminal-en.png) - 5. Open the program and enter the command — `defaults delete com.adguard.mac.vpn`. - 6. Press *Space bar* and enter another command — `rm -f ~/Library/Group\ Containers/TC3Q7MAJXF.com.adguard.mac/Library/Preferences/TC3Q7MAJXF.com.adguard.mac.plist`. AdGuard VPN has been completely removed from your Mac. diff --git a/docs/adguard-vpn-for-mac/overview.md b/docs/adguard-vpn-for-mac/overview.md index a23ce6389..3c5629432 100644 --- a/docs/adguard-vpn-for-mac/overview.md +++ b/docs/adguard-vpn-for-mac/overview.md @@ -74,9 +74,11 @@ Here you can add a custom DNS server (or servers) in order not to rely on a DNS Advanced settings are not recommended to be adjusted. Don't change them unless asked by our technical support or unless you're sure what you're doing. #### Logging level + There are only two logging levels but we strongly recommend that you use the first, default one. The second option (extended logging) should be set only to record a strange program behavior after consulting our technical support. Even if you enabled the second logging level, make sure to go back to the default one after recording logs. #### Hide menu bar icon + Although this option is located in *Advanced settings*, it can be enabled without hesitation. You can hide the AdGuard VPN icon from the menu bar, it won’t prevent our app from running in the background. #### Use QUIC (experimental) diff --git a/docs/adguard-vpn-for-mac/solving-problems/logs.md b/docs/adguard-vpn-for-mac/solving-problems/logs.md index ea671593e..56c90bbd0 100644 --- a/docs/adguard-vpn-for-mac/solving-problems/logs.md +++ b/docs/adguard-vpn-for-mac/solving-problems/logs.md @@ -39,4 +39,4 @@ In most cases, the default logging level is sufficient to trace down possible bu >If for some reason it is more convenient for you to send us logs in another way, you can export them yourself. To do this, select **Settings** → **General** → **Export logs** in the **Actions** section on the right. -This section is updated regularly. If you have not found a solution to your problem in the articles given in this section, contact AdGuard technical support at support@adguard-vpn.com. \ No newline at end of file +This section is updated regularly. If you have not found a solution to your problem in the articles given in this section, contact AdGuard technical support at support@adguard-vpn.com. diff --git a/docs/adguard-vpn-for-windows/overview.md b/docs/adguard-vpn-for-windows/overview.md index a79c2b44e..13d91cc90 100644 --- a/docs/adguard-vpn-for-windows/overview.md +++ b/docs/adguard-vpn-for-windows/overview.md @@ -7,7 +7,7 @@ sidebar_position: 1 A VPN, acronym for "Virtual Private Network", is a service that makes your Internet connection safe and helps you stay anonymous online. How does it work? Every time you visit a website without using a VPN, your ISP sees it. It knows who you are and what you're looking for, and it can collect and sell this data. In it's turn, the website you came to can also track your activity. When you enable a VPN application, it redirects your traffic through an encrypted tunnel to a remote VPN server, ensuring your privacy: the ISP doesn't know where to you sent a request, and the site doesn't know where you came from. -**What AdGuard VPN for Windows does** +## What AdGuard VPN for Windows does * Protects from network traffic interception (spoofing). AdGuard VPN creates an encrypted tunnel between your device and a remote server. All your Internet traffic passes through this tunnel, so your data is protected along the way. And thanks to [AdGuard's unique protocol](/general/adguard-vpn-protocol.mdx), you're guaranteed a fast and secure connection. @@ -75,17 +75,17 @@ The **DNS servers** tab allows you to add your own DNS server. You can set up a It is entirely possible to use AdGuard VPN for Windows without ever touching the Advanced settings, but they can be useful if you're willing to take time to learn what they do. -**Operating mode** +##### Operating mode Despite the fact that there are two operating modes — VPN and SOCKS5 — we advise you to use only the one chosen by default (VPN). When the **VPN mode** is enabled, all the traffic of your device will be directed via AdGuard VPN, while in **SOCKS5 mode** AdGuard VPN uses a local proxy server which can be used by other applications to redirect their traffic. -**Logging level** +##### Logging level Two levels of logging are available to choose from: **Record by default** and **Record everything**. The first option is enabled by default. The **Record everything** option should only be activated if our support team has asked you to do so. Using the app in this mode for an extended period of time result in increased battery consumption. All logs are stored locally on your device and you can send them to the support team if needed. -**Use QUIC** +##### Use QUIC This is an experimental feature that enables AdGuard to use the advanced QUIC encryption protocol. It has many advantages, but the most notable one is that it can improve connection quality under non-ideal conditions, for example, when using mobile Internet or when connecting to public Wi-Fi networks. diff --git a/docs/adguard-vpn-for-windows/solving-problems/logs.md b/docs/adguard-vpn-for-windows/solving-problems/logs.md index 5b7a08a87..06fcdc3c2 100644 --- a/docs/adguard-vpn-for-windows/solving-problems/logs.md +++ b/docs/adguard-vpn-for-windows/solving-problems/logs.md @@ -7,7 +7,6 @@ sidebar position: 1 If you encounter a problem when using AdGuard VPN for Windows, you can inform us about it. We would be grateful if you also send application logs our way, they help us resolving problems much quicker. - ## Collecting and sending standard logs By default, AdGuard VPN for Windows uses the standard logging level, that is, the basic collection of data about running processes of the app. To send these logs, follow the next steps: @@ -22,7 +21,6 @@ By default, AdGuard VPN for Windows uses the standard logging level, that is, th >If for some reason it is more convenient for you to send us logs in another way, you can export them yourself. To do this, go to **Support** → **Export logs and system info**. - ## Collecting and sending extended logs In most cases, the default logging level is sufficient to trace down possible bugs. But there are cases when more detailed technical information about the device and connections is required, and then our support team will ask you to enable the extended logging level. To send this type of logs, follow these steps: diff --git a/docs/general/adguard-vpn-encryption.md b/docs/general/adguard-vpn-encryption.md index cdfb2b6e6..29e6a251a 100644 --- a/docs/general/adguard-vpn-encryption.md +++ b/docs/general/adguard-vpn-encryption.md @@ -9,13 +9,13 @@ Encryption is the reason the word "private" exists in the term "Virtual Private AdGuard VPN protocol uses the most secure and fast encryption algorithm to date – AES-256. Learn what it is and why it is so good. -## AES historical tour +## AES historical tour AES (Advanced Encryption Standard) encryption was developed in the late 20th century at the U.S. government request: the existing Data Encryption Standard (DES) became obsolete and a new, more secure encryption algorithm was required. In a public competition announced by the government won the Rijndael cipher — rather similar to DES but much more sophisticated. In 2002 it was renamed AES and published by the U.S. National Institute of Standards and Technology. -Today, AES is the industry standard for encryption. Because of its open nature, it is used by the NSA and government agencies, as well as private, commercial, and non-profit organizations. +Today, AES is the industry standard for encryption. Because of its open nature, it is used by the NSA and government agencies, as well as private, commercial, and non-profit organizations. ## How AES-256 works diff --git a/docs/general/free-vs-unlimited.md b/docs/general/free-vs-unlimited.md index e0cd47361..fe7bf73a4 100644 --- a/docs/general/free-vs-unlimited.md +++ b/docs/general/free-vs-unlimited.md @@ -2,25 +2,25 @@ title: 'Benefits of AdGuard VPN Unlimited' sidebar_position: 5 --- - + You can use AdGuard VPN for free, but then there will be certain restrictions: * Only 2 devices on which you can simultaneously enable AdGuard VPN -* 3 GB of traffic per month restriction +* 3 GB of traffic per month restriction * 20 Mbit/sec speed limit * Only some of the server locations are available * Email clients can’t be used for sending messages (on iOS and Android) - + > The last point should be addressed separately: free users of AdGuard VPN for iOS and Android cannot send emails in email clients. It’s impossible because we block port 25, which is used for outgoing emails, and thus reinsure against spam. However, sending emails with web email services works perfectly well. And on AdGuard VPN for Android you can add apps to exclusions so that email apps will function as well. -At the same time you can purchase a subscription to get an unlimited version of the app. +At the same time you can purchase a subscription to get an unlimited version of the app. A subscription allows to have more benefits in comparison with a free account: - -* 5 simultaneously connected devices -* Unlimited traffic -* No speed cap + +* 5 simultaneously connected devices +* Unlimited traffic +* No speed cap * All 50+ locations are available * Secure streaming -* No port 25 block +* No port 25 block -To use all the advantages, consider [purchasing a subscription](subscription.md). \ No newline at end of file +To use all the advantages, consider [purchasing a subscription](subscription.md). diff --git a/docs/general/how-to-install.md b/docs/general/how-to-install.md index d9928d8d1..f4cc794f5 100644 --- a/docs/general/how-to-install.md +++ b/docs/general/how-to-install.md @@ -9,4 +9,4 @@ Depending on which AdGuard VPN app or browser extension you want to install, fol * [AdGuard VPN for iOS](/adguard-vpn-for-ios/installation.md) * [AdGuard VPN for Windows](/adguard-vpn-for-windows/installation.md) * [AdGuard VPN for Mac](/adguard-vpn-for-mac/installation.md) -* [AdGuard VPN Browser extension](/adguard-vpn-browser-extension/installation.md) \ No newline at end of file +* [AdGuard VPN Browser extension](/adguard-vpn-browser-extension/installation.md) diff --git a/docs/general/how-vpn-works.md b/docs/general/how-vpn-works.md index b6453518f..b2df962a0 100644 --- a/docs/general/how-vpn-works.md +++ b/docs/general/how-vpn-works.md @@ -12,11 +12,9 @@ A VPN is a Virtual Private Network that helps hide your location and protect you In that way, a VPN performs two important functions: 1. **Maintaining anonymity** - Using an Internet connection, the user leaves their digital footprint, which can then be analyzed and used by third parties. For example, one of the online stores that you have visited can save your search history and then offer you their products based on it through targeted advertising. Or the secret services, having learned your location through the IP address of your device and having determined your identity, can secretly monitor your activity on the web. In addition, web browsers and ISPs themselves can use your browsing history for their own purposes, as well as sell it to advertisers and provide it to government institutions. VPN allows you to hide your IP address and replace it with the IP address of the VPN server to which you are connected. This way you will be able to maintain your privacy and anonymously search for information on the web. 2. **Data protection** - If you connect to an unreliable or public network, the data on your device may become vulnerable to cybercriminals. Bank card details, usernames and passwords, passport data — all this data can be intercepted by online fraudsters. The VPN tunnel encrypts the information that you send and receive from the web, so it can not fall into the wrong hands. ## VPN structure @@ -49,15 +47,15 @@ AdGuard VPN also has its own [*protocol*](adguard-vpn-protocol.mdx). One of its Despite the obvious advantages, VPN is not perfect and has some disadvantages: -**Lower speed** +### Lower speed Since your traffic does not go directly to the web server, but first passes through the VPN server, the speed of the VPN connection decreases. Other factors also affect the speed when using a VPN: the load of the VPN server, its bandwidth, the compatibility of the VPN protocol with your operating system. All these factors, as well as the speed of the network itself, can reduce the quality of your VPN connection. -**Access blocking** +### Access blocking Some online services make a lot of effort to detect VPN traffic and block access to VPN users. However, not many VPNs can mask their traffic as regular. Therefore, many attempts to go to a particular website without disabling VPN end up in nothing. -**VPN connections breaking** +### VPN connections breaking A weak signal, network overload, VPN incompatibility with a firewall, antivirus and other programs, an outdated VPN protocol — all this can cause a sudden failure in the VPN connection, especially by unreliable VPN providers. diff --git a/docs/general/subscription.md b/docs/general/subscription.md index a7b4034b8..0eed37563 100644 --- a/docs/general/subscription.md +++ b/docs/general/subscription.md @@ -9,4 +9,4 @@ If you have decided to purchase a subscription to AdGuard VPN, there are three w 1. Via an in-app purchase. Go to the AdGuard VPN app and tap the arrow in the upper-right corner of the screen. There are three subscription plans to choose from — monthly, yearly, and two-year one. Select the most suitable one and tap "Subscribe". This option is available for AdGuard VPN mobile apps for iOS and Android. 2. Via [AdGuard account](https://my.adguard.com/main.html). Log in to your account and select "My Licenses" from the menu bar. Press "Buy AdGuard VPN" and select a monthly, yearly, or two-year subscription. Pay for it using your card or PayPal account. Done! -3. Finally, you can purchase an AdGuard VPN subscription on [our website](https://adguard-vpn.com/license.html). Choose a convenient subscription option and enter the email address to which the payment receipt will be sent. You can pay for your subscription using your card or PayPal account. \ No newline at end of file +3. Finally, you can purchase an AdGuard VPN subscription on [our website](https://adguard-vpn.com/license.html). Choose a convenient subscription option and enter the email address to which the payment receipt will be sent. You can pay for your subscription using your card or PayPal account. diff --git a/docs/general/why-adguard-vpn.md b/docs/general/why-adguard-vpn.md index 2f62430c0..83d96bee7 100644 --- a/docs/general/why-adguard-vpn.md +++ b/docs/general/why-adguard-vpn.md @@ -8,11 +8,13 @@ When getting ready to commit to a [long-term VPN subscription](subscription.md), *To start with, let’s go over AdGuard VPN’s unmatched features that you won’t find in any other VPN.* ## 1. Proprietary protocol + From the very outset, we resolved to develop and deploy an in-house VPN protocol instead of picking a canned solution — that’d be too easy, plus, we weren’t satisfied with existing protocols. The result has become the [AdGuard VPN protocol](adguard-vpn-protocol.mdx). Choosing a VPN service, people often face a trade-off between fast vs. safe. The AdGuard VPN protocol is a perfect blend of speed and security, so you don’t have to bear slow internet connection or make privacy sacrifices. Among other things, it disguises itself as regular traffic and it’s much harder to detect and block it. ## 2. Exclusions + The *Exclusions lists* allow you to select sites for which the VPN should be enabled and for which — disabled. There are two operation modes in AdGuard VPN: *General* and *Selective*. In *General mode*, VPN works everywhere except websites added to exclusions. And vice versa, in *Selective mode*, VPN works nowhere but on websites added to exclusions. You can also easily import/export exclusions lists. Read about this feature in *Features overview* for the product you are interested in. ![An example of an exclusion list for Selective mode](https://cdn.adguardvpn.com/public/Adguard/Blog/vpn_export_exclusions.png) @@ -22,6 +24,7 @@ You can add websites to exclusions manually or choose them among the lists of po > This feature is available on all platforms except iOS. ## 3. Choosing a DNS server + No more relying on the DNS server provided by your ISP by default! First, it’s not safe: your ISP most likely has access to your browsing history. Second, people often underestimate DNS, yet it can remove ads and trackers, protect your device from malware or, for instance, enable safe search and block adult content. You can choose DNS servers from [known DNS providers](https://adguard-dns.io/kb/general/dns-providers/) such as AdGuard, Cisco, Cloudflare, Google, or Quad9, or even configure to use your own DNS server. @@ -41,25 +44,31 @@ With mobile devices, on the other hand, it’s not that simple. In the vast majo However, we managed to find a solution to befriend AdGuard VPN and AdGuard Ad Blocker. When you have both AdGuard apps installed on one device simultaneously, they will automatically become compatible without any input required from you. This is a unique opportunity to take advantage of two sets of features, which you would normally have to choose between. ## 6. QUIC support + [QUIC](https://adguard.com/blog/dns-over-quic.html) is a cutting-edge protocol that has many perks. The main advantage is it can improve connection quality in non-ideal conditions – for example, on mobile devices or when connecting to public Wi-Fi. Although the new protocol won’t affect speed when the connection is fine and stable, it will definitely make the situation better for users with slow internet. *Now let’s switch to the item set that any decent VPN can't do without.* ## 7. Kill Switch + Kill Switch is essential if you, for instance, often use a mobile network or connect to public Wi-Fi networks in malls, cafes, on the subway or at the airport. For the simple reason — if VPN will suddenly drop and the connection will become insecure, chances are that your sensitive information will be exposed to fraudsters or cyber criminals. If for some reason your VPN connection is interrupted, Kill Switch will automatically disconnect the internet connection, keeping attackers away from seizing your information. With Kill Switch, rest assured that you are in safe hands. If you’re concerned about privacy or at least value your personal data, don’t overlook this bulletproof method. ## 8. Split tunneling + This feature resembles the exclusions lists mentioned above. The only difference is that here you can exclude apps instead of websites. ## 9. Auto-Protection + This feature has been developed specifically for unsecured networks. For the convenience of users, we made it impossible to forget to enable VPN when visiting public places. Should you pop into a coffee shop and connect to a local Wi-Fi network, you’ll be automatically connected to AdGuard VPN. ## 10. Up to five connected devices at a time + AdGuard VPN offers five simultaneous connections to its paid users. We place special emphasis on the word *simultaneous*, and here is why. Some VPN providers only allow to log in to their service on *five devices max*. With AdGuard VPN, *there’s no limit* to the number of devices that can be logged in to your account, but you can have five VPN connections enabled at the same time. Those who don’t have a subscription can use AdGuard VPN on *two devices*, which gives us another trump card to play against competitors — most of the VPN services only have *one device* in their free versions. ## 11. Secure streaming + Streaming services don't like VPNs for obvious reasons: according to statistics, about 20% of users install a VPN mainly to watch shows, TV shows and movies bypassing geo-blocking. That's why streaming platforms tend to do everything they can to track VPN traffic and block it. But what if you want to feel safe while watch content specific to your region? Or don't want stop watching exciting series even when you travel to another country? The answer is simple — AdGuard VPN, which thanks to its unique protocol can remain invisible to services. diff --git a/docs/intro.md b/docs/intro.md index 49f95bb31..246807ae6 100644 --- a/docs/intro.md +++ b/docs/intro.md @@ -25,15 +25,19 @@ Passwords, card details, and just plain personal information are at risk when a ## Why AdGuard VPN? ### Trusted developer + AdGuard has been present on the market of personal data protection and ad blocking and developing its line of software for more than 12 years. Over this time, our company has built an impeccable reputation, and the number of our customers has exceeded 30 million. ### Unique VPN protocol + The main difference between AdGuard VPN and its competitors is that we use [our own developed protocol](/general/adguard-vpn-protocol.mdx). It disguises itself as normal traffic, so it is much more difficult to track and block it. ### No logs policy + No logs policy means that we don’t collect, store or transfer users’ personal data to third parties. The full text of the AdGuard Privacy policy can be found [here](https://adguard-vpn.com/en/privacy.html). ### Tracking protection + Web traffic from any user may be of interest and is particularly valuable in terms of monetization of personal data. Both criminals and unscrupulous ISPs can access it. However, with a trustworthy VPN, you can be confident that neither your provider nor anyone else will see your internet activity. ### Ultrafast VPN servers in 43 countries diff --git a/docs/miscellaneous/acknowledgements.md b/docs/miscellaneous/acknowledgements.md index 8c2bbdd73..3fe2569aa 100644 --- a/docs/miscellaneous/acknowledgements.md +++ b/docs/miscellaneous/acknowledgements.md @@ -31,11 +31,11 @@ Our dev team would like to thank the developers of the third-party software we u ## AdGuard VPN for Windows -* Intercept traffic drivers (wfp & tdi): [https://netfiltersdk.com/nfsdk.html](https://netfiltersdk.com/nfsdk.html) -* WPF-based text editor component: [http://avalonedit.net/](http://avalonedit.net/) +* Intercept traffic drivers (wfp & tdi): [https://netfiltersdk.com/nfsdk.html](https://netfiltersdk.com/nfsdk.html) +* WPF-based text editor component: [http://avalonedit.net/](http://avalonedit.net/) * High-performance JSON framework for .NET: [https://www.newtonsoft.com/json](https://www.newtonsoft.com/json) -## AdGuard VPN Extension +## AdGuard VPN Extension * axios: [https://github.com/axios/axios](https://github.com/axios/axios) * babel: [https://github.com/babel/babel](https://github.com/babel/babel) @@ -72,9 +72,5 @@ Our dev team would like to thank the developers of the third-party software we u ## VPN server -* Netty: [https://netty.io/](https://netty.io/) +* Netty: [https://netty.io/](https://netty.io/) * Quiche: [https://github.com/cloudflare/quiche](https://github.com/cloudflare/quiche) - - - - diff --git a/docs/miscellaneous/take-screenshot.md b/docs/miscellaneous/take-screenshot.md index 2cdeba57b..1b1b92ac4 100644 --- a/docs/miscellaneous/take-screenshot.md +++ b/docs/miscellaneous/take-screenshot.md @@ -3,7 +3,7 @@ title: 'How to take a screenshot' sidebar_position: 4 --- -Screenshot is a capture of your computer’s or mobile device’s screen, which can be obtained by using standard tools or a special program/app. +Screenshot is a capture of your computer’s or mobile device’s screen, which can be obtained by using standard tools or a special program/app. Sometimes a screenshot (or screenshots) is required by support team to better understand the problem, and not everyone knows how to take screenshots, especially of a separate window or a specific screen area on their devices. If you recognize yourself as one of these users, don’t worry. This article will help you as it describes a range of ways to take screenshots on different platforms. @@ -13,7 +13,7 @@ Here you will find all the necessary hotkeys you should know in order to take sc ### Android -Taking a screenshot on an Android device can be done in various ways — depending on the device model and its manufacturer. +Taking a screenshot on an Android device can be done in various ways — depending on the device model and its manufacturer. Generally, you should use the following button combination for Android: @@ -23,7 +23,7 @@ Your Android device will capture the entire screen and save it as a photo. So, y But, as it has been already said, there can be differences depending on a particular device. Let’s look at other possible combinations: -+ **Hold down at once *Home* and *Power* buttons for 1–2 seconds;** ++ **Hold down at once *Home* and *Power* buttons for 1–2 seconds;** + **Hold down at once the *Back* and the *Home* buttons** On Android 8 and later there is also a possibility to take a screenshot by placing your hand vertically along the left or right edge of your phone and swiping in from that edge with your hand touching the screen. @@ -34,7 +34,7 @@ Besides, you can always use any special applications for taking screenshots on y ### iOS -Any iOS device (barring ancient ones) lets you take a screenshot using standard tools. +Any iOS device (barring ancient ones) lets you take a screenshot using standard tools. To take a screenshot on an iOS device, use the following combination: @@ -54,7 +54,7 @@ On some notebooks you have to hold *Fn* and then press *PrtScn* instead. *Please note: PrtScn (Print Screen) button can be differently abbreviated on various keyboards — PrntScrn, PrtScn, PrtScr or PrtSc.* -Windows captures the entire screen and copies it to the (invisible) clipboard. +Windows captures the entire screen and copies it to the (invisible) clipboard. To take a screenshot of an active window, use the following combination: @@ -64,7 +64,7 @@ To take a screenshot of a specific area, you should use the following combinatio + **Hold down *Win* (the Windows button) and *Shift* and press *S*** -After you take a screenshot, it will be saved in the clipboard. In most cases you will be able to paste it into a document that you are currently editing by using *Ctrl + V* button combination. Alternatively, if you need to save the screenshot into a file, you should open the standard **Paint** program (or any other app that can work with images). Paste your screenshot there using the same button combination or by clicking the Paste button (usually in the top left corner of the screen) and then save it. +After you take a screenshot, it will be saved in the clipboard. In most cases you will be able to paste it into a document that you are currently editing by using *Ctrl + V* button combination. Alternatively, if you need to save the screenshot into a file, you should open the standard **Paint** program (or any other app that can work with images). Paste your screenshot there using the same button combination or by clicking the Paste button (usually in the top left corner of the screen) and then save it. Windows 8 and 10 let you take a screenshot very quickly with a *Win + PrtScn* combination. As soon as you press these buttons, the screenshot will be automatically saved as a file to your Pictures → Screenshots Folder. @@ -76,13 +76,13 @@ Besides, you can also try using different apps for taking screenshots on your co To take a screenshot on Mac, use the following button combination: -+ **Press and hold together *⌘ Cmd + Shift + 3*** ++ **Press and hold together *⌘ Cmd + Shift + 3*** -Your Mac will capture the entire screen and save it as a file on the desktop. +Your Mac will capture the entire screen and save it as a file on the desktop. To take a screenshot of an active window, use the following combination: -+ **Press and hold together *⌘ Cmd + Shift + 4 + Space bar*. The pointer will change to a camera icon. Click the window to capture it. Press the Esc button to cancel taking a screenshot** ++ **Press and hold together *⌘ Cmd + Shift + 4 + Space bar*. The pointer will change to a camera icon. Click the window to capture it. Press the Esc button to cancel taking a screenshot** To take a screenshot of a specific area, you should use the following combination: @@ -94,6 +94,6 @@ To take a screenshot of the *Touch Bar* (MacBook Pro) use the following combinat Your Mac captures the entire *Touch Bar* and saves it as a file on the desktop. -To copy a screenshot to the clipboard instead of saving it, hold down *Ctrl* together with any of the combinations above. Then you can paste the screenshot (from the clipboard) into a document or an image you are currently editing by using *Cmd + V* combination. +To copy a screenshot to the clipboard instead of saving it, hold down *Ctrl* together with any of the combinations above. Then you can paste the screenshot (from the clipboard) into a document or an image you are currently editing by using *Cmd + V* combination. You can also take screenshots by using **Preview** and choosing **Take screenshot** (of the selected area, window, or the entire screen). With **Preview** you can save your screenshots in JPG, TIFF, PDF, and other file formats. From 9cc8fa7c2ec28cb52df78cdd99163d369640a890 Mon Sep 17 00:00:00 2001 From: Slava Leleka Date: Tue, 1 Aug 2023 18:14:02 +0300 Subject: [PATCH 02/11] add markdownlint --- package.json | 7 +- yarn.lock | 215 +++++++++++++++++++++++++++++++++++++++++++++++---- 2 files changed, 207 insertions(+), 15 deletions(-) diff --git a/package.json b/package.json index 51bb65dae..5d14fd230 100644 --- a/package.json +++ b/package.json @@ -4,7 +4,7 @@ "private": true, "scripts": { "docusaurus": "docusaurus", - "start": "docusaurus start", + "start": "yarn lint:md && docusaurus start", "build": "docusaurus build", "swizzle": "docusaurus swizzle", "deploy": "yarn crowdin:sync && docusaurus deploy", @@ -12,6 +12,7 @@ "serve": "docusaurus serve", "write-translations": "docusaurus write-translations", "write-heading-ids": "docusaurus write-heading-ids", + "lint:md": "markdownlint .", "crowdin": "crowdin", "crowdin:sync": "docusaurus write-translations && crowdin upload && crowdin download" }, @@ -34,6 +35,10 @@ "ua-parser-js": "^1.0.2", "url-loader": "^4.1.1" }, + "devDependencies": { + "markdownlint": "^0.29.0", + "markdownlint-cli": "^0.35.0" + }, "browserslist": { "production": [ ">0.5%", diff --git a/yarn.lock b/yarn.lock index dbc3142ee..5e1b1f9cd 100644 --- a/yarn.lock +++ b/yarn.lock @@ -2797,6 +2797,18 @@ dependencies: "@hapi/hoek" "^9.0.0" +"@isaacs/cliui@^8.0.2": + version "8.0.2" + resolved "https://registry.yarnpkg.com/@isaacs/cliui/-/cliui-8.0.2.tgz#b37667b7bc181c168782259bab42474fbf52b550" + integrity sha512-O8jcjabXaleOG9DQ0+ARXWZBTfnP4WNAqzuiJK7ll44AmxGKv/J2M4TPjxjY3znBCfvBXFzucm1twdyFybFqEA== + dependencies: + string-width "^5.1.2" + string-width-cjs "npm:string-width@^4.2.0" + strip-ansi "^7.0.1" + strip-ansi-cjs "npm:strip-ansi@^6.0.1" + wrap-ansi "^8.1.0" + wrap-ansi-cjs "npm:wrap-ansi@^7.0.0" + "@jridgewell/gen-mapping@^0.1.0": version "0.1.1" resolved "https://registry.yarnpkg.com/@jridgewell/gen-mapping/-/gen-mapping-0.1.1.tgz#e5d2e450306a9491e3bd77e323e38d7aff315996" @@ -2920,6 +2932,11 @@ "@nodelib/fs.scandir" "2.1.5" fastq "^1.6.0" +"@pkgjs/parseargs@^0.11.0": + version "0.11.0" + resolved "https://registry.yarnpkg.com/@pkgjs/parseargs/-/parseargs-0.11.0.tgz#a77ea742fab25775145434eb1d2328cf5013ac33" + integrity sha512-+1VkjdD0QBLPodGrJUeqarH8VAIvQODIbwh9XpP5Syisf7YoQgsJKPNFoqqLQlu+VQ/tVSshMR6loPMn8U+dPg== + "@polka/url@^1.0.0-next.17": version "1.0.0-next.17" resolved "https://registry.yarnpkg.com/@polka/url/-/url-1.0.0-next.17.tgz#25fdbdfd282c2f86ddf3fcefbd98be99cd2627e2" @@ -4160,6 +4177,13 @@ brace-expansion@^1.1.7: balanced-match "^1.0.0" concat-map "0.0.1" +brace-expansion@^2.0.1: + version "2.0.1" + resolved "https://registry.yarnpkg.com/brace-expansion/-/brace-expansion-2.0.1.tgz#1edc459e0f0c548486ecf9fc99f2221364b9a0ae" + integrity sha512-XnAIvQ8eM+kC6aULx6wuQiwVsnzsi9d3WxzV3FpWTGA19F621kwdbsAcFKXgKUHZWsy+mY6iL1sHTxWEFCytDA== + dependencies: + balanced-match "^1.0.0" + braces@^3.0.1, braces@^3.0.2, braces@~3.0.2: version "3.0.2" resolved "https://registry.yarnpkg.com/braces/-/braces-3.0.2.tgz#3454e1a462ee8d599e236df336cd9ea4f8afe107" @@ -4530,6 +4554,11 @@ commander@^8.3.0: resolved "https://registry.yarnpkg.com/commander/-/commander-8.3.0.tgz#4837ea1b2da67b9c616a67afbb0fafee567bca66" integrity sha512-OkTL9umf+He2DZkUq8f8J9of7yL6RJKI24dVITBmNfZBmri9zYZQrKkuXiKhyfPSu8tUhnVBB1iKXevvnlR4Ww== +commander@~11.0.0: + version "11.0.0" + resolved "https://registry.yarnpkg.com/commander/-/commander-11.0.0.tgz#43e19c25dbedc8256203538e8d7e9346877a6f67" + integrity sha512-9HMlXtt/BNoYr8ooyjjNRdIilOTkVJXB+GhxMTtOKwk0R4j4lS4NpjuqmRxroBfnfTSHQIHQB7wryHhXarNjmQ== + commondir@^1.0.1: version "1.0.1" resolved "https://registry.yarnpkg.com/commondir/-/commondir-1.0.1.tgz#ddd800da0c66127393cca5950ea968a3aaf1253b" @@ -4714,7 +4743,7 @@ cross-fetch@^3.0.4: dependencies: node-fetch "2.6.1" -cross-spawn@^7.0.3: +cross-spawn@^7.0.0, cross-spawn@^7.0.3: version "7.0.3" resolved "https://registry.yarnpkg.com/cross-spawn/-/cross-spawn-7.0.3.tgz#f73a85b9d5d41d045551c177e2882d4ac85728a6" integrity sha512-iRDPJKUPVEND7dHPO8rkbOnPpyDygcDFtWjpeWNCgy8WP2rXcxXL8TskReQl6OrB2G7+UJrags1q15Fudc7G6w== @@ -5283,7 +5312,7 @@ entities@^2.0.0: resolved "https://registry.yarnpkg.com/entities/-/entities-2.2.0.tgz#098dc90ebb83d8dffa089d55256b351d34c4da55" integrity sha512-p92if5Nz619I0w+akJrLZH0MX0Pb5DX39XOwQTtXSdQQOaYH03S1uIQp4mhOZtAXrxq4ViO67YTiLBo2638o9A== -entities@^3.0.1: +entities@^3.0.1, entities@~3.0.1: version "3.0.1" resolved "https://registry.yarnpkg.com/entities/-/entities-3.0.1.tgz#2b887ca62585e96db3903482d336c1006c3001d4" integrity sha512-WiyBqoomrwMdFG1e0kqvASYfnlb0lp8M5o5Fw2OFq1hNZxxcNk8Ik0Xm7LxzBhuidnZB/UtBqVCgUz3kBOP51Q== @@ -5662,6 +5691,14 @@ follow-redirects@^1.14.0, follow-redirects@^1.14.7, follow-redirects@^1.14.8: resolved "https://registry.yarnpkg.com/follow-redirects/-/follow-redirects-1.15.1.tgz#0ca6a452306c9b276e4d3127483e29575e207ad5" integrity sha512-yLAMQs+k0b2m7cVxpS1VKJVvoz7SS9Td1zss3XRwXj+ZDH00RJgnuLx7E44wx02kQLrdM3aOOy+FpzS7+8OizA== +foreground-child@^3.1.0: + version "3.1.1" + resolved "https://registry.yarnpkg.com/foreground-child/-/foreground-child-3.1.1.tgz#1d173e776d75d2772fed08efe4a0de1ea1b12d0d" + integrity sha512-TMKDUnIte6bfb5nWv7V/caI169OHgvwjb7V4WkeUvbQQdjr5rWKqHFiKWb/fcOwB+CzBT+qbWjvj+DVwRskpIg== + dependencies: + cross-spawn "^7.0.0" + signal-exit "^4.0.1" + fork-ts-checker-webpack-plugin@^6.5.0: version "6.5.2" resolved "https://registry.yarnpkg.com/fork-ts-checker-webpack-plugin/-/fork-ts-checker-webpack-plugin-6.5.2.tgz#4f67183f2f9eb8ba7df7177ce3cf3e75cdafb340" @@ -5774,6 +5811,11 @@ get-own-enumerable-property-symbols@^3.0.0: resolved "https://registry.yarnpkg.com/get-own-enumerable-property-symbols/-/get-own-enumerable-property-symbols-3.0.2.tgz#b5fde77f22cbe35f390b4e089922c50bce6ef664" integrity sha512-I0UBV/XOz1XkIJHEUDMZAbzCThU/H8DxmSfmdGcKPnVhu2VfFqr34jr9777IyaTYvxjedWhqVIilEDsCdP5G6g== +get-stdin@~9.0.0: + version "9.0.0" + resolved "https://registry.yarnpkg.com/get-stdin/-/get-stdin-9.0.0.tgz#3983ff82e03d56f1b2ea0d3e60325f39d703a575" + integrity sha512-dVKBjfWisLAicarI2Sf+JuBE/DghV4UzNAVe9yhEJuzeREd3JhOTE9cUaJTeSa77fsbQUK3pcOpJfM59+VKZaA== + get-stream@^4.1.0: version "4.1.0" resolved "https://registry.yarnpkg.com/get-stream/-/get-stream-4.1.0.tgz#c1b255575f3dc21d59bfc79cd3d2b46b1c3a54b5" @@ -5846,6 +5888,17 @@ glob@^7.1.6: once "^1.3.0" path-is-absolute "^1.0.0" +glob@~10.2.7: + version "10.2.7" + resolved "https://registry.yarnpkg.com/glob/-/glob-10.2.7.tgz#9dd2828cd5bc7bd861e7738d91e7113dda41d7d8" + integrity sha512-jTKehsravOJo8IJxUGfZILnkvVJM/MOfHRs8QcXolVef2zNI9Tqyy5+SeuOAZd3upViEZQLyFpQhYiHLrMUNmA== + dependencies: + foreground-child "^3.1.0" + jackspeak "^2.0.3" + minimatch "^9.0.1" + minipass "^5.0.0 || ^6.0.2" + path-scurry "^1.7.0" + global-dirs@^3.0.0: version "3.0.0" resolved "https://registry.yarnpkg.com/global-dirs/-/global-dirs-3.0.0.tgz#70a76fe84ea315ab37b1f5576cbde7d48ef72686" @@ -6329,6 +6382,11 @@ ignore@^5.2.0: resolved "https://registry.yarnpkg.com/ignore/-/ignore-5.2.0.tgz#6d3bac8fa7fe0d45d9f9be7bac2fc279577e345a" integrity sha512-CmxgYGiEPCLhfLnpPp1MoRmifwEIOgjcHXxOBjv7mY96c+eWScsOP9c112ZyLdWHi0FxHjI+4uVhKYp/gcdRmQ== +ignore@~5.2.4: + version "5.2.4" + resolved "https://registry.yarnpkg.com/ignore/-/ignore-5.2.4.tgz#a291c0c6178ff1b960befe47fcdec301674a6324" + integrity sha512-MAb38BcSbH0eHNBxn7ql2NH/kX33OkB3lZ1BNdh7ENeRChHTYsTvWrMubiIAMNS2llXEEgZ1MUOBtXChP3kaFQ== + image-size@^1.0.1: version "1.0.1" resolved "https://registry.yarnpkg.com/image-size/-/image-size-1.0.1.tgz#86d6cfc2b1d19eab5d2b368d4b9194d9e48541c5" @@ -6407,6 +6465,11 @@ ini@^1.3.5, ini@~1.3.0: resolved "https://registry.yarnpkg.com/ini/-/ini-1.3.8.tgz#a29da425b48806f34767a4efce397269af28432c" integrity sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew== +ini@~3.0.0: + version "3.0.1" + resolved "https://registry.yarnpkg.com/ini/-/ini-3.0.1.tgz#c76ec81007875bc44d544ff7a11a55d12294102d" + integrity sha512-it4HyVAUTKBc6m8e1iXWvXSTdndF7HbdN713+kvLrymxTaU4AUBWrJ4vEooP+V7fexnVD3LKcBshjGGPefSMUQ== + inline-style-parser@0.1.1: version "0.1.1" resolved "https://registry.yarnpkg.com/inline-style-parser/-/inline-style-parser-0.1.1.tgz#ec8a3b429274e9c0a1f1c4ffa9453a7fef72cea1" @@ -6719,6 +6782,15 @@ isobject@^3.0.1: resolved "https://registry.yarnpkg.com/isobject/-/isobject-3.0.1.tgz#4e431e92b11a9731636aa1f9c8d1ccbcfdab78df" integrity sha1-TkMekrEalzFjaqH5yNHMvP2reN8= +jackspeak@^2.0.3: + version "2.2.2" + resolved "https://registry.yarnpkg.com/jackspeak/-/jackspeak-2.2.2.tgz#707c62733924b8dc2a0a629dc6248577788b5385" + integrity sha512-mgNtVv4vUuaKA97yxUHoA3+FkuhtxkjdXEWOyB/N76fjy0FjezEt34oy3epBtvCvS+7DyKwqCFWx/oJLV5+kCg== + dependencies: + "@isaacs/cliui" "^8.0.2" + optionalDependencies: + "@pkgjs/parseargs" "^0.11.0" + jest-worker@^27.0.2: version "27.0.6" resolved "https://registry.yarnpkg.com/jest-worker/-/jest-worker-27.0.6.tgz#a5fdb1e14ad34eb228cfe162d9f729cdbfa28aed" @@ -6810,6 +6882,11 @@ json5@^2.2.1: resolved "https://registry.yarnpkg.com/json5/-/json5-2.2.1.tgz#655d50ed1e6f95ad1a3caababd2b0efda10b395c" integrity sha512-1hqLFMSrGHRHxav9q9gNjJ5EXznIxGVO09xQRrwplcS8qs28pZ8s8hupZAmqDwZUmVZ2Qb2jnyPOWcDH8m8dlA== +jsonc-parser@~3.2.0: + version "3.2.0" + resolved "https://registry.yarnpkg.com/jsonc-parser/-/jsonc-parser-3.2.0.tgz#31ff3f4c2b9793f89c67212627c51c6394f88e76" + integrity sha512-gfFQZrcTc8CnKXp6Y4/CBT3fTc0OVuDofpre4aEeEpSBPV5X5v4+Vmx+8snU7RLPrNHPKSgLxGo9YuQzz20o+w== + jsonfile@^6.0.1: version "6.1.0" resolved "https://registry.yarnpkg.com/jsonfile/-/jsonfile-6.1.0.tgz#bc55b2634793c679ec6403094eb13698a6ec0aae" @@ -6863,6 +6940,13 @@ lines-and-columns@^1.1.6: resolved "https://registry.yarnpkg.com/lines-and-columns/-/lines-and-columns-1.1.6.tgz#1c00c743b433cd0a4e80758f7b64a57440d9ff00" integrity sha1-HADHQ7QzzQpOgHWPe2SldEDZ/wA= +linkify-it@^4.0.1: + version "4.0.1" + resolved "https://registry.yarnpkg.com/linkify-it/-/linkify-it-4.0.1.tgz#01f1d5e508190d06669982ba31a7d9f56a5751ec" + integrity sha512-C7bfi1UZmoj8+PQx22XyeXCuBlokoyWQL5pWSP+EI6nzRylyThouddufc2c1NDIcP9k5agmN9fLpA7VNJfIiqw== + dependencies: + uc.micro "^1.0.1" + loader-runner@^4.2.0: version "4.2.0" resolved "https://registry.yarnpkg.com/loader-runner/-/loader-runner-4.2.0.tgz#d7022380d66d14c5fb1d496b89864ebcfd478384" @@ -6970,6 +7054,11 @@ lru-cache@^6.0.0: dependencies: yallist "^4.0.0" +"lru-cache@^9.1.1 || ^10.0.0": + version "10.0.0" + resolved "https://registry.yarnpkg.com/lru-cache/-/lru-cache-10.0.0.tgz#b9e2a6a72a129d81ab317202d93c7691df727e61" + integrity sha512-svTf/fzsKHffP42sujkO/Rjs37BCIsQVRCeNYIm9WN8rgT7ffoUnRtZCqU+6BqcSBdv8gwJeTz8knJpgACeQMw== + lunr-languages@^1.4.0: version "1.9.0" resolved "https://registry.yarnpkg.com/lunr-languages/-/lunr-languages-1.9.0.tgz#7105230807788a112a69910561b7bbd055a0e588" @@ -6992,6 +7081,45 @@ markdown-escapes@^1.0.0: resolved "https://registry.yarnpkg.com/markdown-escapes/-/markdown-escapes-1.0.4.tgz#c95415ef451499d7602b91095f3c8e8975f78535" integrity sha512-8z4efJYk43E0upd0NbVXwgSTQs6cT3T06etieCMEg7dRbzCbxUCK/GHlX8mhHRDcp+OLlHkPKsvqQTCvsRl2cg== +markdown-it@13.0.1: + version "13.0.1" + resolved "https://registry.yarnpkg.com/markdown-it/-/markdown-it-13.0.1.tgz#c6ecc431cacf1a5da531423fc6a42807814af430" + integrity sha512-lTlxriVoy2criHP0JKRhO2VDG9c2ypWCsT237eDiLqi09rmbKoUetyGHq2uOIRoRS//kfoJckS0eUzzkDR+k2Q== + dependencies: + argparse "^2.0.1" + entities "~3.0.1" + linkify-it "^4.0.1" + mdurl "^1.0.1" + uc.micro "^1.0.5" + +markdownlint-cli@^0.35.0: + version "0.35.0" + resolved "https://registry.yarnpkg.com/markdownlint-cli/-/markdownlint-cli-0.35.0.tgz#1a6386777c6f20681e1425c0b7a056cf130bc46f" + integrity sha512-lVIIIV1MrUtjoocgDqXLxUCxlRbn7Ve8rsWppfwciUNwLlNS28AhNiyQ3PU7jjj4Qvj+rWTTvwkqg7AcdG988g== + dependencies: + commander "~11.0.0" + get-stdin "~9.0.0" + glob "~10.2.7" + ignore "~5.2.4" + js-yaml "^4.1.0" + jsonc-parser "~3.2.0" + markdownlint "~0.29.0" + minimatch "~9.0.1" + run-con "~1.2.11" + +markdownlint-micromark@0.1.5: + version "0.1.5" + resolved "https://registry.yarnpkg.com/markdownlint-micromark/-/markdownlint-micromark-0.1.5.tgz#a23400b101be32cd4336f2b6b4c47da31825524c" + integrity sha512-HvofNU4QCvfUCWnocQP1IAWaqop5wpWrB0mKB6SSh0fcpV0PdmQNS6tdUuFew1utpYlUvYYzz84oDkrD76GB9A== + +markdownlint@^0.29.0, markdownlint@~0.29.0: + version "0.29.0" + resolved "https://registry.yarnpkg.com/markdownlint/-/markdownlint-0.29.0.tgz#9647478b7d5485965c557502fe54ee5a550033f2" + integrity sha512-ASAzqpODstu/Qsk0xW5BPgWnK/qjpBQ4e7IpsSvvFXcfYIjanLTdwFRJK1SIEEh0fGSMKXcJf/qhaZYHyME0wA== + dependencies: + markdown-it "13.0.1" + markdownlint-micromark "0.1.5" + mdast-squeeze-paragraphs@^4.0.0: version "4.0.0" resolved "https://registry.yarnpkg.com/mdast-squeeze-paragraphs/-/mdast-squeeze-paragraphs-4.0.0.tgz#7c4c114679c3bee27ef10b58e2e015be79f1ef97" @@ -7035,7 +7163,7 @@ mdn-data@2.0.4: resolved "https://registry.yarnpkg.com/mdn-data/-/mdn-data-2.0.4.tgz#699b3c38ac6f1d728091a64650b65d388502fd5b" integrity sha512-iV3XNKw06j5Q7mi6h+9vbx23Tv7JkjEVgKHW4pimwyDGWm0OIQntJJ+u1C6mg6mK1EaTv42XQ7w76yuzH7M2cA== -mdurl@^1.0.0: +mdurl@^1.0.0, mdurl@^1.0.1: version "1.0.1" resolved "https://registry.yarnpkg.com/mdurl/-/mdurl-1.0.1.tgz#fe85b2ec75a59037f2adfec100fd6c601761152e" integrity sha1-/oWy7HWlkDfyrf7BAP1sYBdhFS4= @@ -7183,11 +7311,33 @@ minimatch@^3.1.1: dependencies: brace-expansion "^1.1.7" +minimatch@^9.0.1, minimatch@~9.0.1: + version "9.0.3" + resolved "https://registry.yarnpkg.com/minimatch/-/minimatch-9.0.3.tgz#a6e00c3de44c3a542bfaae70abfc22420a6da825" + integrity sha512-RHiac9mvaRw0x3AYRgDC1CxAP7HTcNrrECeA8YYJeWnpo+2Q5CegtZjaotWTWxDG3UeGA1coE05iH1mPjT/2mg== + dependencies: + brace-expansion "^2.0.1" + minimist@^1.2.0, minimist@^1.2.3, minimist@^1.2.5: version "1.2.5" resolved "https://registry.yarnpkg.com/minimist/-/minimist-1.2.5.tgz#67d66014b66a6a8aaa0c083c5fd58df4e4e97602" integrity sha512-FM9nNUYrRBAELZQT3xeZQ7fmMOBg6nWNmJKTcgsJeaLstP/UODVpGsr5OhXhhXg6f+qtJ8uiZ+PUxkDWcgIXLw== +minimist@^1.2.8: + version "1.2.8" + resolved "https://registry.yarnpkg.com/minimist/-/minimist-1.2.8.tgz#c1a464e7693302e082a075cee0c057741ac4772c" + integrity sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA== + +"minipass@^5.0.0 || ^6.0.2": + version "6.0.2" + resolved "https://registry.yarnpkg.com/minipass/-/minipass-6.0.2.tgz#542844b6c4ce95b202c0995b0a471f1229de4c81" + integrity sha512-MzWSV5nYVT7mVyWCwn2o7JH13w2TBRmmSqSRCKzTw+lmft9X4z+3wjvs06Tzijo5z4W/kahUCDpRXTF+ZrmF/w== + +"minipass@^5.0.0 || ^6.0.2 || ^7.0.0": + version "7.0.2" + resolved "https://registry.yarnpkg.com/minipass/-/minipass-7.0.2.tgz#58a82b7d81c7010da5bd4b2c0c85ac4b4ec5131e" + integrity sha512-eL79dXrE1q9dBbDCLg7xfn/vl7MS4F1gvJAgjJrQli/jbQWdUttuVawphqpffoIYfRdq78LHx6GP4bU/EQ2ATA== + mkdirp-classic@^0.5.2, mkdirp-classic@^0.5.3: version "0.5.3" resolved "https://registry.yarnpkg.com/mkdirp-classic/-/mkdirp-classic-0.5.3.tgz#fa10c9115cc6d8865be221ba47ee9bed78601113" @@ -7633,6 +7783,14 @@ path-parse@^1.0.6: resolved "https://registry.yarnpkg.com/path-parse/-/path-parse-1.0.7.tgz#fbc114b60ca42b30d9daf5858e4bd68bbedb6735" integrity sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw== +path-scurry@^1.7.0: + version "1.10.1" + resolved "https://registry.yarnpkg.com/path-scurry/-/path-scurry-1.10.1.tgz#9ba6bf5aa8500fe9fd67df4f0d9483b2b0bfc698" + integrity sha512-MkhCqzzBEpPvxxQ71Md0b1Kk51W01lrYvlMzSUaIzNsODdd7mqhiimSZlr+VegAz5Z6Vzt9Xg2ttE//XBhH3EQ== + dependencies: + lru-cache "^9.1.1 || ^10.0.0" + minipass "^5.0.0 || ^6.0.2 || ^7.0.0" + path-to-regexp@0.1.7: version "0.1.7" resolved "https://registry.yarnpkg.com/path-to-regexp/-/path-to-regexp-0.1.7.tgz#df604178005f522f15eb4490e7247a1bfaa67f8c" @@ -8662,6 +8820,16 @@ rtlcss@^3.5.0: postcss "^8.3.11" strip-json-comments "^3.1.1" +run-con@~1.2.11: + version "1.2.12" + resolved "https://registry.yarnpkg.com/run-con/-/run-con-1.2.12.tgz#51c319910e45a3bd71ee773564a89d96635c8c64" + integrity sha512-5257ILMYIF4RztL9uoZ7V9Q97zHtNHn5bN3NobeAnzB1P3ASLgg8qocM2u+R18ttp+VEM78N2LK8XcNVtnSRrg== + dependencies: + deep-extend "^0.6.0" + ini "~3.0.0" + minimist "^1.2.8" + strip-json-comments "~3.1.1" + run-parallel@^1.1.9: version "1.2.0" resolved "https://registry.yarnpkg.com/run-parallel/-/run-parallel-1.2.0.tgz#66d1368da7bdf921eb9d95bd1a9229e7f21a43ee" @@ -8970,6 +9138,11 @@ signal-exit@^3.0.0, signal-exit@^3.0.2, signal-exit@^3.0.3: resolved "https://registry.yarnpkg.com/signal-exit/-/signal-exit-3.0.3.tgz#a1410c2edd8f077b08b4e253c8eacfcaf057461c" integrity sha512-VUJ49FC8U1OxwZLxIbTTrDvLnf/6TDgxZcK8wxR8zs13xpx7xbG60ndBlhNrFi2EMuFRoeDoJO7wthSLq42EjA== +signal-exit@^4.0.1: + version "4.1.0" + resolved "https://registry.yarnpkg.com/signal-exit/-/signal-exit-4.1.0.tgz#952188c1cbd546070e2dd20d0f41c0ae0530cb04" + integrity sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw== + simple-concat@^1.0.0: version "1.0.1" resolved "https://registry.yarnpkg.com/simple-concat/-/simple-concat-1.0.1.tgz#f46976082ba35c2263f1c8ab5edfe26c41c9552f" @@ -9133,7 +9306,7 @@ std-env@^3.0.1: resolved "https://registry.yarnpkg.com/std-env/-/std-env-3.1.1.tgz#1f19c4d3f6278c52efd08a94574a2a8d32b7d092" integrity sha512-/c645XdExBypL01TpFKiG/3RAa/Qmu+zRi0MwAmrdEkwHNuN0ebo8ccAXBBDa5Z0QOJgBskUIbuCK91x0sCVEw== -"string-width@^1.0.2 || 2 || 3 || 4", string-width@^4.2.3: +"string-width-cjs@npm:string-width@^4.2.0", "string-width@^1.0.2 || 2 || 3 || 4", string-width@^4.2.3: version "4.2.3" resolved "https://registry.yarnpkg.com/string-width/-/string-width-4.2.3.tgz#269c7117d27b05ad2e536830a8ec895ef9c6d010" integrity sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g== @@ -9160,7 +9333,7 @@ string-width@^4.0.0, string-width@^4.1.0, string-width@^4.2.0: is-fullwidth-code-point "^3.0.0" strip-ansi "^6.0.0" -string-width@^5.0.1: +string-width@^5.0.1, string-width@^5.1.2: version "5.1.2" resolved "https://registry.yarnpkg.com/string-width/-/string-width-5.1.2.tgz#14f8daec6d81e7221d2a357e668cab73bdbca794" integrity sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA== @@ -9208,6 +9381,13 @@ stringify-object@^3.3.0: is-obj "^1.0.1" is-regexp "^1.0.0" +"strip-ansi-cjs@npm:strip-ansi@^6.0.1", strip-ansi@^6.0.1: + version "6.0.1" + resolved "https://registry.yarnpkg.com/strip-ansi/-/strip-ansi-6.0.1.tgz#9e26c63d30f53443e9489495b2105d37b67a85d9" + integrity sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A== + dependencies: + ansi-regex "^5.0.1" + strip-ansi@^5.1.0: version "5.2.0" resolved "https://registry.yarnpkg.com/strip-ansi/-/strip-ansi-5.2.0.tgz#8c9a536feb6afc962bdfa5b104a5091c1ad9c0ae" @@ -9222,13 +9402,6 @@ strip-ansi@^6.0.0: dependencies: ansi-regex "^5.0.0" -strip-ansi@^6.0.1: - version "6.0.1" - resolved "https://registry.yarnpkg.com/strip-ansi/-/strip-ansi-6.0.1.tgz#9e26c63d30f53443e9489495b2105d37b67a85d9" - integrity sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A== - dependencies: - ansi-regex "^5.0.1" - strip-ansi@^7.0.1: version "7.0.1" resolved "https://registry.yarnpkg.com/strip-ansi/-/strip-ansi-7.0.1.tgz#61740a08ce36b61e50e65653f07060d000975fb2" @@ -9246,7 +9419,7 @@ strip-final-newline@^2.0.0: resolved "https://registry.yarnpkg.com/strip-final-newline/-/strip-final-newline-2.0.0.tgz#89b852fb2fcbe936f6f4b3187afb0a12c1ab58ad" integrity sha512-BrpvfNAE3dcvq7ll3xVumzjKjZQ5tI1sEUIKr3Uoks0XUl45St3FlatVqef9prk4jRDzhW6WZg+3bk93y6pLjA== -strip-json-comments@^3.1.1: +strip-json-comments@^3.1.1, strip-json-comments@~3.1.1: version "3.1.1" resolved "https://registry.yarnpkg.com/strip-json-comments/-/strip-json-comments-3.1.1.tgz#31f1281b3832630434831c310c01cccda8cbe006" integrity sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig== @@ -9563,6 +9736,11 @@ ua-parser-js@^1.0.2: resolved "https://registry.yarnpkg.com/ua-parser-js/-/ua-parser-js-1.0.2.tgz#e2976c34dbfb30b15d2c300b2a53eac87c57a775" integrity sha512-00y/AXhx0/SsnI51fTc0rLRmafiGOM4/O+ny10Ps7f+j/b8p/ZY11ytMgznXkOVo4GQ+KwQG5UQLkLGirsACRg== +uc.micro@^1.0.1, uc.micro@^1.0.5: + version "1.0.6" + resolved "https://registry.yarnpkg.com/uc.micro/-/uc.micro-1.0.6.tgz#9c411a802a409a91fc6cf74081baba34b24499ac" + integrity sha512-8Y75pvTYkLJW2hWQHXxoqRgV7qb9B+9vFEtidML+7koHUFapnVJAZ6cKs+Qjz5Aw3aZWHMC6u0wJE3At+nSGwA== + unbox-primitive@^1.0.1: version "1.0.1" resolved "https://registry.yarnpkg.com/unbox-primitive/-/unbox-primitive-1.0.1.tgz#085e215625ec3162574dc8859abee78a59b14471" @@ -10089,7 +10267,7 @@ wildcard@^2.0.0: resolved "https://registry.yarnpkg.com/wildcard/-/wildcard-2.0.0.tgz#a77d20e5200c6faaac979e4b3aadc7b3dd7f8fec" integrity sha512-JcKqAHLPxcdb9KM49dufGXn2x3ssnfjbcaQdLlfZsL9rH9wgDQjUtDxbo8NE0F6SFvydeu1VhZe7hZuHsB2/pw== -wrap-ansi@^7.0.0: +"wrap-ansi-cjs@npm:wrap-ansi@^7.0.0", wrap-ansi@^7.0.0: version "7.0.0" resolved "https://registry.yarnpkg.com/wrap-ansi/-/wrap-ansi-7.0.0.tgz#67e145cff510a6a6984bdf1152911d69d2eb9e43" integrity sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q== @@ -10107,6 +10285,15 @@ wrap-ansi@^8.0.1: string-width "^5.0.1" strip-ansi "^7.0.1" +wrap-ansi@^8.1.0: + version "8.1.0" + resolved "https://registry.yarnpkg.com/wrap-ansi/-/wrap-ansi-8.1.0.tgz#56dc22368ee570face1b49819975d9b9a5ead214" + integrity sha512-si7QWI6zUMq56bESFvagtmzMdGOtoxfR+Sez11Mobfc7tm+VkUckk9bW2UeffTGVUbOksxmSw0AA2gs8g71NCQ== + dependencies: + ansi-styles "^6.1.0" + string-width "^5.0.1" + strip-ansi "^7.0.1" + wrappy@1: version "1.0.2" resolved "https://registry.yarnpkg.com/wrappy/-/wrappy-1.0.2.tgz#b5243d8f3ec1aa35f1364605bc0d1036e30ab69f" From a836215d887f8049d1573b6ab11b5ea1849f4b0e Mon Sep 17 00:00:00 2001 From: Slava Leleka Date: Tue, 1 Aug 2023 18:14:17 +0300 Subject: [PATCH 03/11] add markdownlint config --- .markdownlint.json | 10 ++++++++++ .markdownlintignore | 2 ++ 2 files changed, 12 insertions(+) create mode 100644 .markdownlint.json create mode 100644 .markdownlintignore diff --git a/.markdownlint.json b/.markdownlint.json new file mode 100644 index 000000000..3a3b807bd --- /dev/null +++ b/.markdownlint.json @@ -0,0 +1,10 @@ +{ + "ul-indent": { "indent": 4 }, + "line-length": { + "stern": true, + "line_length": 120 + }, + "no-bare-urls": false, + "ul-style": { "style": "dash" } + +} diff --git a/.markdownlintignore b/.markdownlintignore new file mode 100644 index 000000000..342537b34 --- /dev/null +++ b/.markdownlintignore @@ -0,0 +1,2 @@ +node_modules/ +i18n/ From f835df964c339b3b85988cc4f60846ed56fa3d54 Mon Sep 17 00:00:00 2001 From: Slava Leleka Date: Tue, 1 Aug 2023 18:14:35 +0300 Subject: [PATCH 04/11] autofix md linter --- .../adguard-vpn-browser-extension/overview.md | 4 +- docs/adguard-vpn-for-android/overview.md | 6 +- docs/adguard-vpn-for-ios/overview.md | 8 +- docs/adguard-vpn-for-windows/overview.md | 6 +- docs/general/free-vs-unlimited.md | 22 ++--- docs/general/how-to-install.md | 10 +- docs/general/how-vpn-works.md | 14 +-- docs/intro.md | 92 +++++++++---------- docs/miscellaneous/acknowledgements.md | 92 +++++++++---------- docs/miscellaneous/beta-testing.md | 8 +- docs/miscellaneous/take-screenshot.md | 24 ++--- 11 files changed, 143 insertions(+), 143 deletions(-) diff --git a/docs/adguard-vpn-browser-extension/overview.md b/docs/adguard-vpn-browser-extension/overview.md index 9597d91c9..82e165874 100644 --- a/docs/adguard-vpn-browser-extension/overview.md +++ b/docs/adguard-vpn-browser-extension/overview.md @@ -9,8 +9,8 @@ AdGuard VPN Browser extension is available for Chrome, Firefox, and Edge. The UI To manage your AdGuard VPN Browser extension, either -* Click its icon on the browser's panel, then click three stripes and select *Settings*, or -* Go to your browser's *Manage extensions* page and enter the AdGuard VPN's settings from there. +- Click its icon on the browser's panel, then click three stripes and select *Settings*, or +- Go to your browser's *Manage extensions* page and enter the AdGuard VPN's settings from there. Once done, you'll see several tabs on the left: diff --git a/docs/adguard-vpn-for-android/overview.md b/docs/adguard-vpn-for-android/overview.md index 048718305..2a37e9eb6 100644 --- a/docs/adguard-vpn-for-android/overview.md +++ b/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). diff --git a/docs/adguard-vpn-for-ios/overview.md b/docs/adguard-vpn-for-ios/overview.md index 38328d3d0..1917ab8a2 100644 --- a/docs/adguard-vpn-for-ios/overview.md +++ b/docs/adguard-vpn-for-ios/overview.md @@ -9,10 +9,10 @@ A VPN allows you to create a secure connection to another network on the Interne Speaking of AdGuard VPN, it has several functions: -* hides your real whereabouts and helps you stay anonymous -* сhanges your IP address to protect your data from tracking -* encrypts your traffic to make it unreachable to scammers -* lets you configure where to use VPN and where not to (exclusions feature) +- hides your real whereabouts and helps you stay anonymous +- changes your IP address to protect your data from tracking +- encrypts your traffic to make it unreachable to scammers +- lets you configure where to use VPN and where not to (exclusions feature) The next advantage of AdGuard VPN for iOS is our own VPN protocol. It has two main benefits: comparing to other VPN protocols it is extremely hard to detect and it works stably even with a poor Internet connection. You can read more about AdGuard VPN protocol [in this article](../general/adguard-vpn-protocol.mdx). diff --git a/docs/adguard-vpn-for-windows/overview.md b/docs/adguard-vpn-for-windows/overview.md index 13d91cc90..a3a1e923e 100644 --- a/docs/adguard-vpn-for-windows/overview.md +++ b/docs/adguard-vpn-for-windows/overview.md @@ -9,11 +9,11 @@ A VPN, acronym for "Virtual Private Network", is a service that makes your Inter ## What AdGuard VPN for Windows does -* Protects from network traffic interception (spoofing). AdGuard VPN creates an encrypted tunnel between your device and a remote server. All your Internet traffic passes through this tunnel, so your data is protected along the way. And thanks to [AdGuard's unique protocol](/general/adguard-vpn-protocol.mdx), you're guaranteed a fast and secure connection. +- Protects from network traffic interception (spoofing). AdGuard VPN creates an encrypted tunnel between your device and a remote server. All your Internet traffic passes through this tunnel, so your data is protected along the way. And thanks to [AdGuard's unique protocol](/general/adguard-vpn-protocol.mdx), you're guaranteed a fast and secure connection. -* Masks your IP address. Your true IP address is the key to your personal data for cybercriminals. Your name, email address, phone number, credit card information can all fall into the hands of fraudsters if you don't hide your IP. With AdGuard VPN, as we said before, all your traffic goes through an encrypted tunnel and comes to the VPN server. Therefore, from the outside it appears that your device has the IP address of said VPN server. +- Masks your IP address. Your true IP address is the key to your personal data for cybercriminals. Your name, email address, phone number, credit card information can all fall into the hands of fraudsters if you don't hide your IP. With AdGuard VPN, as we said before, all your traffic goes through an encrypted tunnel and comes to the VPN server. Therefore, from the outside it appears that your device has the IP address of said VPN server. -* Hides your real location. By selecting any of the AdGuard VPN servers, you are instantly "teleported" to its location. What does this give you? For example, the ability to book a hotel at locals' rates or hide from geotargeted advertising. +- Hides your real location. By selecting any of the AdGuard VPN servers, you are instantly "teleported" to its location. What does this give you? For example, the ability to book a hotel at locals' rates or hide from geotargeted advertising. AdGuard VPN for Windows has many advantages, so we've dedicated [a separate article](/general/why-adguard-vpn.md) to them. Here, however, we want to focus more on the application itself and how it works. diff --git a/docs/general/free-vs-unlimited.md b/docs/general/free-vs-unlimited.md index fe7bf73a4..ad90d5dbc 100644 --- a/docs/general/free-vs-unlimited.md +++ b/docs/general/free-vs-unlimited.md @@ -5,22 +5,22 @@ sidebar_position: 5 You can use AdGuard VPN for free, but then there will be certain restrictions: -* Only 2 devices on which you can simultaneously enable AdGuard VPN -* 3 GB of traffic per month restriction -* 20 Mbit/sec speed limit -* Only some of the server locations are available -* Email clients can’t be used for sending messages (on iOS and Android) +- Only 2 devices on which you can simultaneously enable AdGuard VPN +- 3 GB of traffic per month restriction +- 20 Mbit/sec speed limit +- Only some of the server locations are available +- Email clients can’t be used for sending messages (on iOS and Android) > The last point should be addressed separately: free users of AdGuard VPN for iOS and Android cannot send emails in email clients. It’s impossible because we block port 25, which is used for outgoing emails, and thus reinsure against spam. However, sending emails with web email services works perfectly well. And on AdGuard VPN for Android you can add apps to exclusions so that email apps will function as well. At the same time you can purchase a subscription to get an unlimited version of the app. A subscription allows to have more benefits in comparison with a free account: -* 5 simultaneously connected devices -* Unlimited traffic -* No speed cap -* All 50+ locations are available -* Secure streaming -* No port 25 block +- 5 simultaneously connected devices +- Unlimited traffic +- No speed cap +- All 50+ locations are available +- Secure streaming +- No port 25 block To use all the advantages, consider [purchasing a subscription](subscription.md). diff --git a/docs/general/how-to-install.md b/docs/general/how-to-install.md index f4cc794f5..dd9d6bbfd 100644 --- a/docs/general/how-to-install.md +++ b/docs/general/how-to-install.md @@ -5,8 +5,8 @@ sidebar_position: 3 Depending on which AdGuard VPN app or browser extension you want to install, follow one of these links to find the relevant article: -* [AdGuard VPN for Android](/adguard-vpn-for-android/installation.md) -* [AdGuard VPN for iOS](/adguard-vpn-for-ios/installation.md) -* [AdGuard VPN for Windows](/adguard-vpn-for-windows/installation.md) -* [AdGuard VPN for Mac](/adguard-vpn-for-mac/installation.md) -* [AdGuard VPN Browser extension](/adguard-vpn-browser-extension/installation.md) +- [AdGuard VPN for Android](/adguard-vpn-for-android/installation.md) +- [AdGuard VPN for iOS](/adguard-vpn-for-ios/installation.md) +- [AdGuard VPN for Windows](/adguard-vpn-for-windows/installation.md) +- [AdGuard VPN for Mac](/adguard-vpn-for-mac/installation.md) +- [AdGuard VPN Browser extension](/adguard-vpn-browser-extension/installation.md) diff --git a/docs/general/how-vpn-works.md b/docs/general/how-vpn-works.md index b2df962a0..adbe69dba 100644 --- a/docs/general/how-vpn-works.md +++ b/docs/general/how-vpn-works.md @@ -63,20 +63,20 @@ A weak signal, network overload, VPN incompatibility with a firewall, antivirus Our VPN service has several important [advantages](why-adguard-vpn.md): -* [*Proprietary VPN protocol*](adguard-vpn-protocol.mdx), which works stably even with a slow Internet connection and disguises itself as normal traffic, making it more difficult to track and block it +- [*Proprietary VPN protocol*](adguard-vpn-protocol.mdx), which works stably even with a slow Internet connection and disguises itself as normal traffic, making it more difficult to track and block it -* [*"No-logs" policy*](https://adguard-vpn.com/en/privacy.html), which means that AdGuard VPN does not collect your personal data and does not transfer it to third parties +- [*"No-logs" policy*](https://adguard-vpn.com/en/privacy.html), which means that AdGuard VPN does not collect your personal data and does not transfer it to third parties -* *More than 50 VPN servers in dozens of countries* +- *More than 50 VPN servers in dozens of countries* -* *Ease of use and extensive customization options* +- *Ease of use and extensive customization options* Currently, AdGuard VPN is available as: -* [Browser extension](../adguard-vpn-browser-extension/overview.md) for Chrome, Firefox, and Edge +- [Browser extension](../adguard-vpn-browser-extension/overview.md) for Chrome, Firefox, and Edge -* Mobile app for [Android](../adguard-vpn-for-android/overview.md) and [iOS](../adguard-vpn-for-ios/overview.md) +- Mobile app for [Android](../adguard-vpn-for-android/overview.md) and [iOS](../adguard-vpn-for-ios/overview.md) -* Desktop application for [Windows](../adguard-vpn-for-windows/overview.md) and [Mac](../adguard-vpn-for-mac/overview.md) +- Desktop application for [Windows](../adguard-vpn-for-windows/overview.md) and [Mac](../adguard-vpn-for-mac/overview.md) You can learn more about AdGuard VPN features (including the unlimited version) [here](https://adguard-vpn.com/en/welcome.html). diff --git a/docs/intro.md b/docs/intro.md index 246807ae6..c47e86d34 100644 --- a/docs/intro.md +++ b/docs/intro.md @@ -16,9 +16,9 @@ Speaking of VPN, the first thing they mention is traffic encryption and security VPN can be used to: -* hide your real whereabouts and stay anonymous -* secure your data — even when connecting to a public Wi-Fi, you can browse the Web safely -* protect yourself from spoofing (network traffic interception) and tracking on the part of your Internet service provider +- hide your real whereabouts and stay anonymous +- secure your data — even when connecting to a public Wi-Fi, you can browse the Web safely +- protect yourself from spoofing (network traffic interception) and tracking on the part of your Internet service provider Passwords, card details, and just plain personal information are at risk when a user surfs the Internet. But if you connect to the global network using a VPN, you can be sure that no one can intercept your data. @@ -42,46 +42,46 @@ Web traffic from any user may be of interest and is particularly valuable in ter ### Ultrafast VPN servers in 43 countries -* Argentina -* Australia -* Austria -* Belgium -* Brazil -* Bulgaria -* Cambodia -* Canada -* China -* Czech Republic -* Denmark -* Egypt -* Finland -* France -* Germany -* Greece -* India -* Ireland -* Israel -* Italy -* Japan -* Luxembourg -* Mexico -* Netherlands -* Norway -* Philippines -* Poland -* Romania -* Russia -* Serbia -* Singapore -* South Africa -* South Korea -* Spain -* Sweden -* Switzerland -* Taiwan -* Turkey -* United Kingdom -* UAE -* USA -* Ukraine -* Vietnam +- Argentina +- Australia +- Austria +- Belgium +- Brazil +- Bulgaria +- Cambodia +- Canada +- China +- Czech Republic +- Denmark +- Egypt +- Finland +- France +- Germany +- Greece +- India +- Ireland +- Israel +- Italy +- Japan +- Luxembourg +- Mexico +- Netherlands +- Norway +- Philippines +- Poland +- Romania +- Russia +- Serbia +- Singapore +- South Africa +- South Korea +- Spain +- Sweden +- Switzerland +- Taiwan +- Turkey +- United Kingdom +- UAE +- USA +- Ukraine +- Vietnam diff --git a/docs/miscellaneous/acknowledgements.md b/docs/miscellaneous/acknowledgements.md index 3fe2569aa..b7868defa 100644 --- a/docs/miscellaneous/acknowledgements.md +++ b/docs/miscellaneous/acknowledgements.md @@ -7,70 +7,70 @@ Our dev team would like to thank the developers of the third-party software we u ## AdGuard Websites -* Symfony: [http://symfony.com/](http://symfony.com/) -* React: [https://reactjs.org/](https://reactjs.org/) -* Vue: [https://vuejs.org/](https://vuejs.org/) -* PostgreSQL: [https://www.postgresql.org/](https://www.postgresql.org/) -* Spring: [https://spring.io/](https://spring.io/) +- Symfony: [http://symfony.com/](http://symfony.com/) +- React: [https://reactjs.org/](https://reactjs.org/) +- Vue: [https://vuejs.org/](https://vuejs.org/) +- PostgreSQL: [https://www.postgresql.org/](https://www.postgresql.org/) +- Spring: [https://spring.io/](https://spring.io/) ## AdGuard VPN for Android -* Logback-android by Tony19: [https://tony19.github.io/logback-android](https://tony19.github.io/logback-android) +- Logback-android by Tony19: [https://tony19.github.io/logback-android](https://tony19.github.io/logback-android) ## AdGuard VPN for iOS -* Zip: [https://github.com/marmelroy/Zip](https://github.com/marmelroy/Zip) -* ReachabilitySwift: [https://github.com/ashleymills/Reachability.swift](https://github.com/ashleymills/Reachability.swift) -* Sentry: [https://github.com/getsentry/sentry-cocoa](https://github.com/getsentry/sentry-cocoa) +- Zip: [https://github.com/marmelroy/Zip](https://github.com/marmelroy/Zip) +- ReachabilitySwift: [https://github.com/ashleymills/Reachability.swift](https://github.com/ashleymills/Reachability.swift) +- Sentry: [https://github.com/getsentry/sentry-cocoa](https://github.com/getsentry/sentry-cocoa) ## AdGuard VPN for Mac -* Punycode component by Kojiro Futamura: [https://github.com/gumob/PunycodeSwift](https://github.com/gumob/PunycodeSwift) -* Reachability component by Ashley Mills: [https://github.com/ashleymills/Reachability.swift](https://github.com/ashleymills/Reachability.swift) -* Sparkle Project for Sparkle.framework component: [https://sparkle-project.org/](https://github.com/ashleymills/Reachability.swift) +- Punycode component by Kojiro Futamura: [https://github.com/gumob/PunycodeSwift](https://github.com/gumob/PunycodeSwift) +- Reachability component by Ashley Mills: [https://github.com/ashleymills/Reachability.swift](https://github.com/ashleymills/Reachability.swift) +- Sparkle Project for Sparkle.framework component: [https://sparkle-project.org/](https://github.com/ashleymills/Reachability.swift) ## AdGuard VPN for Windows -* Intercept traffic drivers (wfp & tdi): [https://netfiltersdk.com/nfsdk.html](https://netfiltersdk.com/nfsdk.html) -* WPF-based text editor component: [http://avalonedit.net/](http://avalonedit.net/) -* High-performance JSON framework for .NET: [https://www.newtonsoft.com/json](https://www.newtonsoft.com/json) +- Intercept traffic drivers (wfp & tdi): [https://netfiltersdk.com/nfsdk.html](https://netfiltersdk.com/nfsdk.html) +- WPF-based text editor component: [http://avalonedit.net/](http://avalonedit.net/) +- High-performance JSON framework for .NET: [https://www.newtonsoft.com/json](https://www.newtonsoft.com/json) ## AdGuard VPN Extension -* axios: [https://github.com/axios/axios](https://github.com/axios/axios) -* babel: [https://github.com/babel/babel](https://github.com/babel/babel) -* commander: [https://github.com/tj/commander.js/](https://github.com/tj/commander.js/) -* date-fns: [https://github.com/date-fns/date-fns](https://github.com/date-fns/date-fns) -* eslint: [https://github.com/eslint/eslint](https://github.com/eslint/eslint) -* jest: [https://github.com/facebook/jest](https://github.com/facebook/jest) -* lodash: [https://github.com/lodash/lodash](https://github.com/lodash/lodash) -* mobx: [https://github.com/mobxjs/mobx](https://github.com/mobxjs/mobx) -* nanoid: [https://github.com/ai/nanoid](https://github.com/ai/nanoid) -* postcss: [https://github.com/postcss/postcss](https://github.com/postcss/postcss) -* react: [https://github.com/facebook/react](https://github.com/facebook/react) -* tldts: [https://github.com/remusao/tldts](https://github.com/facebook/react) -* typescript: [https://github.com/microsoft/TypeScript](https://github.com/microsoft/TypeScript) -* webextension-polyfill: [https://github.com/mozilla/webextension-polyfill](https://github.com/mozilla/webextension-polyfill) -* webpack: [https://github.com/webpack/webpack](https://github.com/webpack/webpack) -* xstate: [https://github.com/statelyai/xstate](https://github.com/statelyai/xstate) +- axios: [https://github.com/axios/axios](https://github.com/axios/axios) +- babel: [https://github.com/babel/babel](https://github.com/babel/babel) +- commander: [https://github.com/tj/commander.js/](https://github.com/tj/commander.js/) +- date-fns: [https://github.com/date-fns/date-fns](https://github.com/date-fns/date-fns) +- eslint: [https://github.com/eslint/eslint](https://github.com/eslint/eslint) +- jest: [https://github.com/facebook/jest](https://github.com/facebook/jest) +- lodash: [https://github.com/lodash/lodash](https://github.com/lodash/lodash) +- mobx: [https://github.com/mobxjs/mobx](https://github.com/mobxjs/mobx) +- nanoid: [https://github.com/ai/nanoid](https://github.com/ai/nanoid) +- postcss: [https://github.com/postcss/postcss](https://github.com/postcss/postcss) +- react: [https://github.com/facebook/react](https://github.com/facebook/react) +- tldts: [https://github.com/remusao/tldts](https://github.com/facebook/react) +- typescript: [https://github.com/microsoft/TypeScript](https://github.com/microsoft/TypeScript) +- webextension-polyfill: [https://github.com/mozilla/webextension-polyfill](https://github.com/mozilla/webextension-polyfill) +- webpack: [https://github.com/webpack/webpack](https://github.com/webpack/webpack) +- xstate: [https://github.com/statelyai/xstate](https://github.com/statelyai/xstate) ## VPN apps -* BoringSSL: [https://github.com/google/boringssl](https://github.com/google/boringssl) -* brotli: [https://github.com/google/brotli](https://github.com/google/brotli) -* Detours: [https://github.com/microsoft/Detours](https://github.com/microsoft/Detours) -* FF/FFOS libs: [https://github.com/stsaz/ff](https://github.com/stsaz/ff) -* Google test: [https://github.com/google/googletest](https://github.com/google/googletest) -* http-parser: [https://github.com/nodejs/http-parser](https://github.com/nodejs/http-parser) -* klib: [https://github.com/attractivechaos/klib](https://github.com/attractivechaos/klib) -* libevent: [https://github.com/libevent/libevent](https://github.com/libevent/libevent) -* lwIP: [https://lwip.fandom.com/wiki/LwIP_Wiki](https://lwip.fandom.com/wiki/LwIP_Wiki) -* nghttp2: [https://github.com/nghttp2/nghttp2](https://github.com/nghttp2/nghttp2) -* Protocol Buffers - Google's data interchange format: [https://github.com/protocolbuffers](https://github.com/protocolbuffers) -* zlib: [https://zlib.net](https://zlib.net) -* Sciter: [https://sciter.com/](https://sciter.com/) +- BoringSSL: [https://github.com/google/boringssl](https://github.com/google/boringssl) +- brotli: [https://github.com/google/brotli](https://github.com/google/brotli) +- Detours: [https://github.com/microsoft/Detours](https://github.com/microsoft/Detours) +- FF/FFOS libs: [https://github.com/stsaz/ff](https://github.com/stsaz/ff) +- Google test: [https://github.com/google/googletest](https://github.com/google/googletest) +- http-parser: [https://github.com/nodejs/http-parser](https://github.com/nodejs/http-parser) +- klib: [https://github.com/attractivechaos/klib](https://github.com/attractivechaos/klib) +- libevent: [https://github.com/libevent/libevent](https://github.com/libevent/libevent) +- lwIP: [https://lwip.fandom.com/wiki/LwIP_Wiki](https://lwip.fandom.com/wiki/LwIP_Wiki) +- nghttp2: [https://github.com/nghttp2/nghttp2](https://github.com/nghttp2/nghttp2) +- Protocol Buffers - Google's data interchange format: [https://github.com/protocolbuffers](https://github.com/protocolbuffers) +- zlib: [https://zlib.net](https://zlib.net) +- Sciter: [https://sciter.com/](https://sciter.com/) ## VPN server -* Netty: [https://netty.io/](https://netty.io/) -* Quiche: [https://github.com/cloudflare/quiche](https://github.com/cloudflare/quiche) +- Netty: [https://netty.io/](https://netty.io/) +- Quiche: [https://github.com/cloudflare/quiche](https://github.com/cloudflare/quiche) diff --git a/docs/miscellaneous/beta-testing.md b/docs/miscellaneous/beta-testing.md index c1a20a1bf..5c0aa1461 100644 --- a/docs/miscellaneous/beta-testing.md +++ b/docs/miscellaneous/beta-testing.md @@ -13,12 +13,12 @@ To become an AdGuard VPN beta tester, you only need a few things: the desire, th Let’s imagine it happened — you spotted a bug. Or maybe you just want to share your suggestion with developers? Anyway, there are several ways to let us know: -* Go to [forum.adguard.com](https://forum.adguard.com) and post there a new thread (or find an existing one) in [the 'Beta Testing' category of the forum](https://forum.adguard.com/index.php?categories/48/). Make sure to read [forum rules](https://forum.adguard.com/index.php?threads/14859/) first; +- Go to [forum.adguard.com](https://forum.adguard.com) and post there a new thread (or find an existing one) in [the 'Beta Testing' category of the forum](https://forum.adguard.com/index.php?categories/48/). Make sure to read [forum rules](https://forum.adguard.com/index.php?threads/14859/) first; -* Go to [GitHub](https://github.com/AdguardTeam/) and find a suitable repository. Create a new issue there and describe the bug/feature request in detail. +- Go to [GitHub](https://github.com/AdguardTeam/) and find a suitable repository. Create a new issue there and describe the bug/feature request in detail. The above two methods are the most preferred, but you can use others if necessary: -* Find us on various social media platforms, like [Facebook](https://www.facebook.com/AdguardEn/), [Reddit](https://www.reddit.com/r/Adguard/), etc. However, this is not the most efficient way to discuss technical matters. +- Find us on various social media platforms, like [Facebook](https://www.facebook.com/AdguardEn/), [Reddit](https://www.reddit.com/r/Adguard/), etc. However, this is not the most efficient way to discuss technical matters. -* Email our support team from the Support tab in the app or write directly to [support@adguard.com](mailto:support@adguard.com). +- Email our support team from the Support tab in the app or write directly to [support@adguard.com](mailto:support@adguard.com). diff --git a/docs/miscellaneous/take-screenshot.md b/docs/miscellaneous/take-screenshot.md index 1b1b92ac4..186bfc084 100644 --- a/docs/miscellaneous/take-screenshot.md +++ b/docs/miscellaneous/take-screenshot.md @@ -17,14 +17,14 @@ Taking a screenshot on an Android device can be done in various ways — dependi Generally, you should use the following button combination for Android: -+ **Hold down at once the *Volume Down* and the *Power* buttons for 1–2 seconds** +- **Hold down at once the *Volume Down* and the *Power* buttons for 1–2 seconds** Your Android device will capture the entire screen and save it as a photo. So, you can find the screenshot in a Screenshots folder in your Gallery. But, as it has been already said, there can be differences depending on a particular device. Let’s look at other possible combinations: -+ **Hold down at once *Home* and *Power* buttons for 1–2 seconds;** -+ **Hold down at once the *Back* and the *Home* buttons** +- **Hold down at once *Home* and *Power* buttons for 1–2 seconds;** +- **Hold down at once the *Back* and the *Home* buttons** On Android 8 and later there is also a possibility to take a screenshot by placing your hand vertically along the left or right edge of your phone and swiping in from that edge with your hand touching the screen. @@ -38,17 +38,17 @@ Any iOS device (barring ancient ones) lets you take a screenshot using standard To take a screenshot on an iOS device, use the following combination: -+ **Press the *Sleep/Wake* (side) button and the *Home* button at the same time, then quickly release them** +- **Press the *Sleep/Wake* (side) button and the *Home* button at the same time, then quickly release them** and this one for iPhone X or later: -+ **Press the *Sleep/Wake* button and the *Volume Up* button at the same time, then quickly release them** +- **Press the *Sleep/Wake* button and the *Volume Up* button at the same time, then quickly release them** Your iOS device will capture the entire screen and save it as a photo. You can find it in a standard Photo app. ### Windows -+ **To take a screenshot on Windows, press the *PrtScn* button** +- **To take a screenshot on Windows, press the *PrtScn* button** On some notebooks you have to hold *Fn* and then press *PrtScn* instead. @@ -58,11 +58,11 @@ Windows captures the entire screen and copies it to the (invisible) clipboard. To take a screenshot of an active window, use the following combination: -+ **Hold down *Alt* and press *PrtScn* (or *Fn + Alt + PrtScn* on some laptops)** +- **Hold down *Alt* and press *PrtScn* (or *Fn + Alt + PrtScn* on some laptops)** To take a screenshot of a specific area, you should use the following combination: -+ **Hold down *Win* (the Windows button) and *Shift* and press *S*** +- **Hold down *Win* (the Windows button) and *Shift* and press *S*** After you take a screenshot, it will be saved in the clipboard. In most cases you will be able to paste it into a document that you are currently editing by using *Ctrl + V* button combination. Alternatively, if you need to save the screenshot into a file, you should open the standard **Paint** program (or any other app that can work with images). Paste your screenshot there using the same button combination or by clicking the Paste button (usually in the top left corner of the screen) and then save it. @@ -76,21 +76,21 @@ Besides, you can also try using different apps for taking screenshots on your co To take a screenshot on Mac, use the following button combination: -+ **Press and hold together *⌘ Cmd + Shift + 3*** +- **Press and hold together *⌘ Cmd + Shift + 3*** Your Mac will capture the entire screen and save it as a file on the desktop. To take a screenshot of an active window, use the following combination: -+ **Press and hold together *⌘ Cmd + Shift + 4 + Space bar*. The pointer will change to a camera icon. Click the window to capture it. Press the Esc button to cancel taking a screenshot** +- **Press and hold together *⌘ Cmd + Shift + 4 + Space bar*. The pointer will change to a camera icon. Click the window to capture it. Press the Esc button to cancel taking a screenshot** To take a screenshot of a specific area, you should use the following combination: -+ **Press and hold together *⌘ Cmd + Shift + 4***. Drag the crosshair to select the needed area. Release your mouse or trackpad to take a screenshot, press the Esc button to cancel it. +- **Press and hold together *⌘ Cmd + Shift + 4***. Drag the crosshair to select the needed area. Release your mouse or trackpad to take a screenshot, press the Esc button to cancel it. To take a screenshot of the *Touch Bar* (MacBook Pro) use the following combination: -+ **Hold down *⌘ Cmd + Shift + 6*** +- **Hold down *⌘ Cmd + Shift + 6*** Your Mac captures the entire *Touch Bar* and saves it as a file on the desktop. From bbbf396159d9f143d2240db16122539de9882160 Mon Sep 17 00:00:00 2001 From: Slava Leleka Date: Tue, 1 Aug 2023 18:40:06 +0300 Subject: [PATCH 05/11] disable line-length rule --- .markdownlint.json | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/.markdownlint.json b/.markdownlint.json index 3a3b807bd..111b51270 100644 --- a/.markdownlint.json +++ b/.markdownlint.json @@ -1,9 +1,6 @@ { "ul-indent": { "indent": 4 }, - "line-length": { - "stern": true, - "line_length": 120 - }, + "line-length": false, "no-bare-urls": false, "ul-style": { "style": "dash" } From 3a18603fa2a34da3f8c05ceb071eeb7701f0f962 Mon Sep 17 00:00:00 2001 From: Slava Leleka Date: Tue, 1 Aug 2023 18:43:11 +0300 Subject: [PATCH 06/11] disable link-fragments rule --- .markdownlint.json | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.markdownlint.json b/.markdownlint.json index 111b51270..0e9a52479 100644 --- a/.markdownlint.json +++ b/.markdownlint.json @@ -1,7 +1,7 @@ { "ul-indent": { "indent": 4 }, + "ul-style": { "style": "dash" }, "line-length": false, "no-bare-urls": false, - "ul-style": { "style": "dash" } - + "link-fragments": false } From edc595160b6a80f94d097e0065790d2990acc2e7 Mon Sep 17 00:00:00 2001 From: Slava Leleka Date: Tue, 1 Aug 2023 18:43:26 +0300 Subject: [PATCH 07/11] fix list style --- .../solving-problems/restricted-mode.md | 24 +++++++++---------- 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/docs/adguard-vpn-for-android/solving-problems/restricted-mode.md b/docs/adguard-vpn-for-android/solving-problems/restricted-mode.md index eae8bae15..d976d083f 100644 --- a/docs/adguard-vpn-for-android/solving-problems/restricted-mode.md +++ b/docs/adguard-vpn-for-android/solving-problems/restricted-mode.md @@ -13,25 +13,25 @@ You have two ways to solve the issue: 1. Activate the **developer mode** and enable **USB debugging**: -- Open the **Settings** application on your phone; -- Go to **System** section (last item in the settings menu). In this section find sub-item **About phone**; -- Click the **Build number** line 7 times. After that, you will receive a notification that **You are now a developer** (If necessary, enter an unlock code for the device); -- Open **System Settings** → **Developer Options** → Scroll down and enable **USB debugging** → Confirm debugging is enabled in the window **Allow USB debugging** after reading the warning carefully. + - Open the **Settings** application on your phone; + - Go to **System** section (last item in the settings menu). In this section find sub-item **About phone**; + - Click the **Build number** line 7 times. After that, you will receive a notification that **You are now a developer** (If necessary, enter an unlock code for the device); + - Open **System Settings** → **Developer Options** → Scroll down and enable **USB debugging** → Confirm debugging is enabled in the window **Allow USB debugging** after reading the warning carefully. -> If you have any difficulties or additional questions, full instructions can be found [here](https://developer.android.com/studio/debug/dev-options). + > If you have any difficulties or additional questions, full instructions can be found [here](https://developer.android.com/studio/debug/dev-options). -2. [Install and configure](https://www.xda-developers.com/install-adb-windows-macos-linux/) ADB; +1. [Install and configure](https://www.xda-developers.com/install-adb-windows-macos-linux/) ADB; -> On the Windows platform, **Samsung** owners may need to install [this utility](https://developer.samsung.com/mobile/android-usb-driver.html). + > On the Windows platform, **Samsung** owners may need to install [this utility](https://developer.samsung.com/mobile/android-usb-driver.html). -3. Connect your device using a **USB cable** to the computer or laptop on which you installed **ADB**; +1. Connect your device using a **USB cable** to the computer or laptop on which you installed **ADB**; -4. Open **the command line** on your PC: +1. Open **the command line** on your PC: -- **Cmd.exe** if you are using **Windows**; -- **Terminal** if you are using **macOS**; + - **Cmd.exe** if you are using **Windows**; + - **Terminal** if you are using **macOS**; -5. Enter the command `adb shell pm grant com.adguard.vpn android.permission.INTERACT_ACROSS_USERS` and press **Enter**. +1. Enter the command `adb shell pm grant com.adguard.vpn android.permission.INTERACT_ACROSS_USERS` and press **Enter**. ### Option 2: Remove *Restricted user account* From 7c97adffae4592957f38b24239daff71d730644b Mon Sep 17 00:00:00 2001 From: Slava Leleka Date: Tue, 1 Aug 2023 18:46:16 +0300 Subject: [PATCH 08/11] add lint md workflow --- .github/workflows/markdown-lint.yml | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 .github/workflows/markdown-lint.yml diff --git a/.github/workflows/markdown-lint.yml b/.github/workflows/markdown-lint.yml new file mode 100644 index 000000000..4c1671339 --- /dev/null +++ b/.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 From 6254b98ea07d0f56d75573595b1bcef4d03299d3 Mon Sep 17 00:00:00 2001 From: Slava Leleka Date: Tue, 1 Aug 2023 18:52:38 +0300 Subject: [PATCH 09/11] update yarn.lock --- yarn.lock | 24 +++++++++--------------- 1 file changed, 9 insertions(+), 15 deletions(-) diff --git a/yarn.lock b/yarn.lock index b774db951..95e24a0dd 100644 --- a/yarn.lock +++ b/yarn.lock @@ -7351,16 +7351,19 @@ minimist@^1.2.0, minimist@^1.2.3, minimist@^1.2.5: resolved "https://registry.yarnpkg.com/minimist/-/minimist-1.2.5.tgz#67d66014b66a6a8aaa0c083c5fd58df4e4e97602" integrity sha512-FM9nNUYrRBAELZQT3xeZQ7fmMOBg6nWNmJKTcgsJeaLstP/UODVpGsr5OhXhhXg6f+qtJ8uiZ+PUxkDWcgIXLw== -<<<<<<< HEAD -minimist@^1.2.8: -======= -minimist@^1.2.6: ->>>>>>> master +minimist@^1.2.6, minimist@^1.2.8: version "1.2.8" resolved "https://registry.yarnpkg.com/minimist/-/minimist-1.2.8.tgz#c1a464e7693302e082a075cee0c057741ac4772c" integrity sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA== -<<<<<<< HEAD +minipass@^2.6.0, minipass@^2.9.0: + version "2.9.0" + resolved "https://registry.yarnpkg.com/minipass/-/minipass-2.9.0.tgz#e713762e7d3e32fed803115cf93e04bca9fcc9a6" + integrity sha512-wxfUjg9WebH+CUDX/CdbRlh5SmfZiy/hpkxaRI16Y9W56Pa75sWgd/rvFilSgrauD9NyFymP/+JFV3KwzIsJeg== + dependencies: + safe-buffer "^5.1.2" + yallist "^3.0.0" + "minipass@^5.0.0 || ^6.0.2": version "6.0.2" resolved "https://registry.yarnpkg.com/minipass/-/minipass-6.0.2.tgz#542844b6c4ce95b202c0995b0a471f1229de4c81" @@ -7370,14 +7373,6 @@ minimist@^1.2.6: version "7.0.2" resolved "https://registry.yarnpkg.com/minipass/-/minipass-7.0.2.tgz#58a82b7d81c7010da5bd4b2c0c85ac4b4ec5131e" integrity sha512-eL79dXrE1q9dBbDCLg7xfn/vl7MS4F1gvJAgjJrQli/jbQWdUttuVawphqpffoIYfRdq78LHx6GP4bU/EQ2ATA== -======= -minipass@^2.6.0, minipass@^2.9.0: - version "2.9.0" - resolved "https://registry.yarnpkg.com/minipass/-/minipass-2.9.0.tgz#e713762e7d3e32fed803115cf93e04bca9fcc9a6" - integrity sha512-wxfUjg9WebH+CUDX/CdbRlh5SmfZiy/hpkxaRI16Y9W56Pa75sWgd/rvFilSgrauD9NyFymP/+JFV3KwzIsJeg== - dependencies: - safe-buffer "^5.1.2" - yallist "^3.0.0" minizlib@^1.3.3: version "1.3.3" @@ -7385,7 +7380,6 @@ minizlib@^1.3.3: integrity sha512-6ZYMOEnmVsdCeTJVE0W9ZD+pVnE8h9Hma/iOwwRDsdQoePpoX56/8B6z3P9VNwppJuBKNRuFDRNRqRWexT9G9Q== dependencies: minipass "^2.9.0" ->>>>>>> master mkdirp-classic@^0.5.2, mkdirp-classic@^0.5.3: version "0.5.3" From 2c0c0e443288f80a14642c71535cbacae6785f49 Mon Sep 17 00:00:00 2001 From: Slava Leleka Date: Tue, 1 Aug 2023 19:02:33 +0300 Subject: [PATCH 10/11] autofix and fix some lists --- .../adguard-vpn-browser-extension/overview.md | 4 +- .../solving-problems/logs.md | 58 +++++----- .../solving-problems/chromecast.md | 4 +- .../solving-problems/access-issues.md | 18 +-- docs/adguard-vpn-for-mac/overview.md | 2 +- docs/adguard-vpn-for-windows/installation.md | 26 ++--- .../common-installer-errors.md | 38 +++---- docs/general/dns-leaks.md | 14 +-- docs/general/free-vs-unlimited.md | 22 ++-- docs/intro.md | 106 +++++++++--------- docs/miscellaneous/acknowledgements.md | 26 ++--- 11 files changed, 159 insertions(+), 159 deletions(-) diff --git a/docs/adguard-vpn-browser-extension/overview.md b/docs/adguard-vpn-browser-extension/overview.md index 3deecff63..78a58f839 100644 --- a/docs/adguard-vpn-browser-extension/overview.md +++ b/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: diff --git a/docs/adguard-vpn-browser-extension/solving-problems/logs.md b/docs/adguard-vpn-browser-extension/solving-problems/logs.md index 87ca97505..f66646397 100644 --- a/docs/adguard-vpn-browser-extension/solving-problems/logs.md +++ b/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 `devteam@adguard.com` 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 `devteam@adguard.com` 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 `devteam@adguard.com` 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 `devteam@adguard.com` 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 `devteam@adguard.com` 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 `devteam@adguard.com` 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 `devteam@adguard.com` 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 `devteam@adguard.com` 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 `devteam@adguard.com` 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 `devteam@adguard.com` attaching the Google Drive link to your issue on GitHub. \ No newline at end of file +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 `devteam@adguard.com` 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 `devteam@adguard.com` attaching the Google Drive link to your issue on GitHub. diff --git a/docs/adguard-vpn-for-android/solving-problems/chromecast.md b/docs/adguard-vpn-for-android/solving-problems/chromecast.md index 3ebcaaab3..0157d6d1f 100644 --- a/docs/adguard-vpn-for-android/solving-problems/chromecast.md +++ b/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. \ No newline at end of file +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. diff --git a/docs/adguard-vpn-for-ios/solving-problems/access-issues.md b/docs/adguard-vpn-for-ios/solving-problems/access-issues.md index 0569651bf..7de215b77 100644 --- a/docs/adguard-vpn-for-ios/solving-problems/access-issues.md +++ b/docs/adguard-vpn-for-ios/solving-problems/access-issues.md @@ -1,18 +1,18 @@ --- -title: Usage issues with subscriptions purchased via the App Store +title: Usage issues with subscriptions purchased via the App Store sidebar_position: 4 --- -Some users can't use their AdGuard VPN subscription purchased through the App Store. This issue may occur in two cases: +Some users can't use their AdGuard VPN subscription purchased through the App Store. This issue may occur in two cases: -* if you use a different account for App Store purchases -* or if you have hidden your email address from app developers +- if you use a different account for App Store purchases +- or if you have hidden your email address from app developers To solve this problem, please follow these steps: -1. Go to Settings → Apple ID → iTunes & App Store → View Apple ID -2. Make sure that the email address matches the one you use for your Apple ID -3. If the email addresses do not match, please email to `support@adguard.com`: describe your problem and provide us with the address used for the App Store -4. If the email addresses match, navigate to Apple ID → iCloud → Hide My Email, find our app in the list, copy the email address, and send it to `support@adguard.com` along with your problem description. Usually, it ends with "@privaterelay.appleid.com" +1. Go to Settings → Apple ID → iTunes & App Store → View Apple ID +1. Make sure that the email address matches the one you use for your Apple ID +1. If the email addresses do not match, please email to `support@adguard.com`: describe your problem and provide us with the address used for the App Store +1. If the email addresses match, navigate to Apple ID → iCloud → Hide My Email, find our app in the list, copy the email address, and send it to `support@adguard.com` along with your problem description. Usually, it ends with "@privaterelay.appleid.com" -Once the support team has the email address you used for the purchase, they'll transfer your subscription to the correct account and you'll be able to start using it. Or they may ask for additional information. You can provide the support team with your Apple purchase receipt to help speed up the process. +Once the support team has the email address you used for the purchase, they'll transfer your subscription to the correct account and you'll be able to start using it. Or they may ask for additional information. You can provide the support team with your Apple purchase receipt to help speed up the process. diff --git a/docs/adguard-vpn-for-mac/overview.md b/docs/adguard-vpn-for-mac/overview.md index 0157f4090..3c5e5d4fd 100644 --- a/docs/adguard-vpn-for-mac/overview.md +++ b/docs/adguard-vpn-for-mac/overview.md @@ -45,7 +45,7 @@ What’s more, ready-made exclusions lists can be transferred to other devices w ![Support screen](https://cdn.adguardvpn.com/content/kb/vpn/mac/support_en.png) -The third tab is the *Support* screen. Find answers to any questions in the [FAQ](https://adguard-vpn.com/welcome.html#faq) or in the [Knowledge base](/intro.md) sections, report a bug if you encounter one, or [discuss AdGuard on any of the platforms](https://adguard.com/discuss.html). And feel free to [leave feedback about our product](https://surveys.adguard.com/vpn_mac/form.html), we’d appreciate it. +The third tab is the *Support* screen. Find answers to any questions in the [FAQ](https://adguard-vpn.com/welcome.html#faq) or in the [Knowledge base](/intro.md) sections, report a bug if you encounter one, or [discuss AdGuard on any of the platforms](https://adguard.com/discuss.html). And feel free to [leave feedback about our product](https://surveys.adguard.com/vpn_mac/form.html), we’d appreciate it. ## Settings diff --git a/docs/adguard-vpn-for-windows/installation.md b/docs/adguard-vpn-for-windows/installation.md index c6bcca056..2c6b768a4 100644 --- a/docs/adguard-vpn-for-windows/installation.md +++ b/docs/adguard-vpn-for-windows/installation.md @@ -27,24 +27,24 @@ If you decide to remove AdGuard VPN from your computer, use one of three options In case regular uninstall doesn't work for any reason, you can try to use an advanced method. First of all, you need to [download the uninstaller tool](https://cdn.adtidy.org/distr/windows/Uninstall_Utility.zip) created by our developers. Extract the archive to any folder on your PC, run the **Adguard.UninstallUtility.exe** file, and allow the app to make changes to your device. Then follow the instruction below: -* Choose *Standard uninstall*, ***Delete AdGuard VPN*** and click *Uninstall*. +- Choose *Standard uninstall*, ***Delete AdGuard VPN*** and click *Uninstall*. -![Standard uninstall *border](https://cdn.adguardvpn.com/content/kb/ad_blocker/windows/installation/standard-uninstall.png) - -* Wait until uninstall is finished — there will be a string in the window: + ![Standard uninstall *border](https://cdn.adguardvpn.com/content/kb/ad_blocker/windows/installation/standard-uninstall.png) + +- Wait until uninstall is finished — there will be a string in the window: `[OK] Uninstall finished` - -![Uninstall finished *border](https://cdn.adguardvpn.com/content/kb/ad_blocker/windows/installation/standard-uninstall-2.png) -> Follow the next steps only if performing first two steps wasn’t enough for some reason. We strongly recommend contacting our support team before using steps 3–4 of advanced uninstall instruction. + ![Uninstall finished *border](https://cdn.adguardvpn.com/content/kb/ad_blocker/windows/installation/standard-uninstall-2.png) + + > Follow the next steps only if performing first two steps wasn’t enough for some reason. We strongly recommend contacting our support team before using steps 3–4 of advanced uninstall instruction. -* Choose *Advanced uninstall*, ***Delete AdGuard VPN*** and click *Uninstall*. +- Choose *Advanced uninstall*, ***Delete AdGuard VPN*** and click *Uninstall*. -![Advanced uninstall *border](https://cdn.adguardvpn.com/content/kb/ad_blocker/windows/installation/advanced-uninstall.png) - -* Wait until uninstall is finished — there will be a string in the window: + ![Advanced uninstall *border](https://cdn.adguardvpn.com/content/kb/ad_blocker/windows/installation/advanced-uninstall.png) + +- Wait until uninstall is finished — there will be a string in the window: `[OK] Uninstall finished` -![Uninstall finished *border](https://cdn.adguardvpn.com/content/kb/ad_blocker/windows/installation/advanced-uninstall-2.png) - + ![Uninstall finished *border](https://cdn.adguardvpn.com/content/kb/ad_blocker/windows/installation/advanced-uninstall-2.png) + AdGuard is successfully uninstalled! diff --git a/docs/adguard-vpn-for-windows/solving-problems/common-installer-errors.md b/docs/adguard-vpn-for-windows/solving-problems/common-installer-errors.md index dccec9bc9..0bc8ca57a 100644 --- a/docs/adguard-vpn-for-windows/solving-problems/common-installer-errors.md +++ b/docs/adguard-vpn-for-windows/solving-problems/common-installer-errors.md @@ -31,11 +31,11 @@ You could say this is a particular subtype of Error 1603. The possible solutions - Start and re-register Microsoft Installer service. It requires some work. - 1) Press *Win + R* and enter **services.msc**. - 2) Find in the list and double click *Windows Installer*. - 3) Hit *Start* button under *Service status* and hit *OK*. If the service status is **running**, you should click *Stop* first and then hit *Start*. - 4) Press *Win + R*, type and enter ***msiexec /unregister*** and hit *Enter*. - 5) Press *Win + R* again, type and enter ***msiexec /regserver*** and hit *Enter* + 1. Press *Win + R* and enter **services.msc**. + 1. Find in the list and double click *Windows Installer*. + 1. Hit *Start* button under *Service status* and hit *OK*. If the service status is **running**, you should click *Stop* first and then hit *Start*. + 1. Press *Win + R*, type and enter ***msiexec /unregister*** and hit *Enter*. + 1. Press *Win + R* again, type and enter ***msiexec /regserver*** and hit *Enter* - Reboot the PC and start the installation all over again. Sometimes that's enough to fix the problem. @@ -61,23 +61,23 @@ The error sounds scarier than it actually is. In reality, this is a rather gener - Start and re-register Microsoft Installer service. It requires some work. - 1) Press *Win + R* and enter ***services.msc***. - 2) Find in the list and double click *Windows Installer*. - 3) Hit *Start* button under *Service status* and hit *OK*. If the service status is **running**, you should click *Stop* first and then hit *Start*. - 4) Press *Win + R*, type and enter ***msiexec /unregister*** and hit *Enter*. - 5) Press *Win + R* again, type and enter ***msiexec /regserver*** and hit *Enter* + 1. Press *Win + R* and enter ***services.msc***. + 1. Find in the list and double click *Windows Installer*. + 1. Hit *Start* button under *Service status* and hit *OK*. If the service status is **running**, you should click *Stop* first and then hit *Start*. + 1. Press *Win + R*, type and enter ***msiexec /unregister*** and hit *Enter*. + 1. Press *Win + R* again, type and enter ***msiexec /regserver*** and hit *Enter* - Acquire full permissions on the drive for installation. It is possible that the error 1603 occurs because you don’t have full permissions on the file location. It's also not as easy as some of the other solutions: - 1) Open *File Explorer*, right-click the drive containing the installation location, and select *Properties*. - 2) Go to *Security* tab and click *Edit*. - 3) Single-click *SYSTEM* and ensure that the *Allow* box of every item in *Permissions for SYSTEM* is checked (if it is checkable). Do the same check for *Administrators*. - 4) Click *OK* to go back to *Properties* dialog. Then click *Advanced*. - 5) Click *Change Permissions*. - 6) In *Permissions* tab, double-click *Administrators*. - 7) Select *This folder, subfolders and files* for the *Applies to* field and tick all the available *Basic permissions*. After that hit *OK*. - 8) Do the same operation above (from item 7) for *SYSTEM*. - 9) Click *OK* all the way out. Try installing AdGuard again. + 1. Open *File Explorer*, right-click the drive containing the installation location, and select *Properties*. + 1. Go to *Security* tab and click *Edit*. + 1. Single-click *SYSTEM* and ensure that the *Allow* box of every item in *Permissions for SYSTEM* is checked (if it is checkable). Do the same check for *Administrators*. + 1. Click *OK* to go back to *Properties* dialog. Then click *Advanced*. + 1. Click *Change Permissions*. + 1. In *Permissions* tab, double-click *Administrators*. + 1. Select *This folder, subfolders and files* for the *Applies to* field and tick all the available *Basic permissions*. After that hit *OK*. + 1. Do the same operation above (from item 7) for *SYSTEM*. + 1. Click *OK* all the way out. Try installing AdGuard again. ### Error 1618: Another installation is already in progress {#error-1618} diff --git a/docs/general/dns-leaks.md b/docs/general/dns-leaks.md index c55810a08..089e1c122 100644 --- a/docs/general/dns-leaks.md +++ b/docs/general/dns-leaks.md @@ -17,7 +17,7 @@ There are all sorts of anonymity check services for detecting DNS leaks, such as Some security scanning websites consider the coincidence of the user's IP address and the DNS server's IP address to be a "good" result, indicating that there are no leaks. In reality, such a match may indicate the use of a VPN. When VPN is disabled and the requests go to your ISP's DNS server, the IP address of the DNS server and your own one do not coincide. -## Why there are no DNS leaks in AdGuard VPN +## Why there are no DNS leaks in AdGuard VPN If you enable AdGuard VPN on your device and run a check on any of the scanner websites, it finds that DNS queries go to the [AdGuard DNS](https://adguard-dns.io) servers. However, this cannot be considered a leak. @@ -29,14 +29,14 @@ And in the case of AdGuard DNS you will "merge" with 50 million users so nobody ## How to set up a custom DNS server in AdGuard VPN -There are many popular public DNS servers from [well-known DNS providers](https://adguard-dns.io/kb/general/dns-providers). Some of them can only perform their direct duties – giving the IP addresses of the requested domains, and some can do more. +There are many popular public DNS servers from [well-known DNS providers](https://adguard-dns.io/kb/general/dns-providers). Some of them can only perform their direct duties – giving the IP addresses of the requested domains, and some can do more. For example, AdGuard DNS removes ads and protects your device from being tracked, and AdGuard DNS Family Protection combines AdGuard DNS features with Safe search and Parental control. You can select any DNS server and configure it in AdGuard VPN: -* in AdGuard VPN for Windows: *Settings* → *App settings* → *DNS servers* -* in AdGuard VPN for Mac: *Settings* → *App settings* → *DNS servers* -* in AdGuard VPN for Android: *Settings* (gear icon) → *App settings* → *DNS server* -* in AdGuard VPN for iOS: *Settings* (gear icon) → *App settings* → *DNS server* -* in AdGuard VPN Browser extension: the hamburger menu icon → *Settings* → *DNS server* +- in AdGuard VPN for Windows: *Settings* → *App settings* → *DNS servers* +- in AdGuard VPN for Mac: *Settings* → *App settings* → *DNS servers* +- in AdGuard VPN for Android: *Settings* (gear icon) → *App settings* → *DNS server* +- in AdGuard VPN for iOS: *Settings* (gear icon) → *App settings* → *DNS server* +- in AdGuard VPN Browser extension: the hamburger menu icon → *Settings* → *DNS server* diff --git a/docs/general/free-vs-unlimited.md b/docs/general/free-vs-unlimited.md index 6074d74ce..268ee5a8e 100644 --- a/docs/general/free-vs-unlimited.md +++ b/docs/general/free-vs-unlimited.md @@ -5,22 +5,22 @@ sidebar_position: 5 You can use AdGuard VPN for free, but then there will be certain restrictions: -* Only 2 devices on which you can simultaneously enable AdGuard VPN -* 3 GB of traffic per month restriction -* 20 Mbit/sec speed limit -* Only some of the server locations are available -* Email clients can’t be used for sending messages (on iOS and Android) +- Only 2 devices on which you can simultaneously enable AdGuard VPN +- 3 GB of traffic per month restriction +- 20 Mbit/sec speed limit +- Only some of the server locations are available +- Email clients can’t be used for sending messages (on iOS and Android) > The last point should be addressed separately: free users of AdGuard VPN for iOS and Android cannot send emails in email clients. It’s impossible because we block port 25, which is used for outgoing emails, and thus reinsure against spam. However, sending emails with web email services works perfectly well. And on AdGuard VPN for Android you can add apps to exclusions so that email apps will function as well. At the same time you can purchase a subscription to get an unlimited version of the app. A subscription allows to have more benefits in comparison with a free account: -* 10 simultaneously connected devices -* Unlimited traffic -* No speed cap -* All 50+ locations are available -* Secure streaming -* No port 25 block +- 10 simultaneously connected devices +- Unlimited traffic +- No speed cap +- All 50+ locations are available +- Secure streaming +- No port 25 block To use all the advantages, consider [purchasing a subscription](subscription.md). diff --git a/docs/intro.md b/docs/intro.md index ebfda17bf..5812fce58 100644 --- a/docs/intro.md +++ b/docs/intro.md @@ -42,56 +42,56 @@ Web traffic from any user may be of interest and is particularly valuable in ter ### Ultrafast VPN servers in 53 countries -* Argentina -* Australia -* Austria -* Belgium -* Brazil -* Bulgaria -* Cambodia -* Canada -* Chile -* Colombia -* Croatia -* Cyprus -* Czechia -* Denmark -* Egypt -* Estonia -* Finland -* France -* Germany -* Greece -* Hong Kong -* Hungary -* India -* Ireland -* Israel -* Italy -* Japan -* Kazakhstan -* Luxembourg -* Mexico -* Netherlands -* New Zealand -* Norway -* Philippines -* Poland -* Portugal -* Romania -* Russia -* Serbia -* Singapore -* Slovakia -* South Africa -* South Korea -* Spain -* Sweden -* Switzerland -* Taiwan -* Turkey -* United Kingdom -* United Arab Emirates -* United States of America -* Ukraine -* Vietnam +- Argentina +- Australia +- Austria +- Belgium +- Brazil +- Bulgaria +- Cambodia +- Canada +- Chile +- Colombia +- Croatia +- Cyprus +- Czechia +- Denmark +- Egypt +- Estonia +- Finland +- France +- Germany +- Greece +- Hong Kong +- Hungary +- India +- Ireland +- Israel +- Italy +- Japan +- Kazakhstan +- Luxembourg +- Mexico +- Netherlands +- New Zealand +- Norway +- Philippines +- Poland +- Portugal +- Romania +- Russia +- Serbia +- Singapore +- Slovakia +- South Africa +- South Korea +- Spain +- Sweden +- Switzerland +- Taiwan +- Turkey +- United Kingdom +- United Arab Emirates +- United States of America +- Ukraine +- Vietnam diff --git a/docs/miscellaneous/acknowledgements.md b/docs/miscellaneous/acknowledgements.md index d059a3b0b..1b16cfc12 100644 --- a/docs/miscellaneous/acknowledgements.md +++ b/docs/miscellaneous/acknowledgements.md @@ -56,19 +56,19 @@ Our dev team would like to thank the developers of the third-party software we u ## VPN apps -* BoringSSL: [https://github.com/google/boringssl](https://github.com/google/boringssl) -* brotli: [https://github.com/google/brotli](https://github.com/google/brotli) -* Detours: [https://github.com/microsoft/Detours](https://github.com/microsoft/Detours) -* FF/FFOS libs: [https://github.com/stsaz/ffos](https://github.com/stsaz/ffos) -* Google test: [https://github.com/google/googletest](https://github.com/google/googletest) -* http-parser: [https://github.com/nodejs/http-parser](https://github.com/nodejs/http-parser) -* klib: [https://github.com/attractivechaos/klib](https://github.com/attractivechaos/klib) -* libevent: [https://github.com/libevent/libevent](https://github.com/libevent/libevent) -* lwIP: [https://lwip.fandom.com/wiki/LwIP_Wiki](https://lwip.fandom.com/wiki/LwIP_Wiki) -* nghttp2: [https://github.com/nghttp2/nghttp2](https://github.com/nghttp2/nghttp2) -* Protocol Buffers - Google's data interchange format: [https://github.com/protocolbuffers](https://github.com/protocolbuffers) -* zlib: [https://zlib.net](https://zlib.net) -* Sciter: [https://sciter.com/](https://sciter.com/) +- BoringSSL: [https://github.com/google/boringssl](https://github.com/google/boringssl) +- brotli: [https://github.com/google/brotli](https://github.com/google/brotli) +- Detours: [https://github.com/microsoft/Detours](https://github.com/microsoft/Detours) +- FF/FFOS libs: [https://github.com/stsaz/ffos](https://github.com/stsaz/ffos) +- Google test: [https://github.com/google/googletest](https://github.com/google/googletest) +- http-parser: [https://github.com/nodejs/http-parser](https://github.com/nodejs/http-parser) +- klib: [https://github.com/attractivechaos/klib](https://github.com/attractivechaos/klib) +- libevent: [https://github.com/libevent/libevent](https://github.com/libevent/libevent) +- lwIP: [https://lwip.fandom.com/wiki/LwIP_Wiki](https://lwip.fandom.com/wiki/LwIP_Wiki) +- nghttp2: [https://github.com/nghttp2/nghttp2](https://github.com/nghttp2/nghttp2) +- Protocol Buffers - Google's data interchange format: [https://github.com/protocolbuffers](https://github.com/protocolbuffers) +- zlib: [https://zlib.net](https://zlib.net) +- Sciter: [https://sciter.com/](https://sciter.com/) ## VPN server From b2b025f2c587fe15e32a4785373bd9baab7fd3df Mon Sep 17 00:00:00 2001 From: Slava Leleka Date: Tue, 1 Aug 2023 19:06:54 +0300 Subject: [PATCH 11/11] fix one more list --- docs/adguard-vpn-for-ios/installation.md | 15 +++++++++------ 1 file changed, 9 insertions(+), 6 deletions(-) diff --git a/docs/adguard-vpn-for-ios/installation.md b/docs/adguard-vpn-for-ios/installation.md index d7594cb07..4137b7d9b 100644 --- a/docs/adguard-vpn-for-ios/installation.md +++ b/docs/adguard-vpn-for-ios/installation.md @@ -13,14 +13,17 @@ You can download and install the *AdGuard VPN for iOS* app for free in the *App 1. Open the *App Store* app on your device and tap *Search* in the bottom right corner of the screen. -![App Store](https://cdn.adguardvpn.com/content/kb/vpn/ios/app-store-en.png) -2. Next, in the search bar, start typing *"AdGuard"* and select *"adguard vpn"* from the list of suggested options. + ![App Store](https://cdn.adguardvpn.com/content/kb/vpn/ios/app-store-en.png) -![Search](https://cdn.adguardvpn.com/content/kb/vpn/ios/search-en.png) -3. Select *AdGuard VPN - Unlimited & Fast* from the list of suggested applications and tap *Download*. If necessary, enter your Apple ID account password in the opened window. +1. Next, in the search bar, start typing *"AdGuard"* and select *"adguard vpn"* from the list of suggested options. -![AdGuard VPN](https://cdn.adguardvpn.com/content/kb/vpn/ios/adguard-vpn-en.png) -4. Wait for the download to finish and tap *Open*. + ![Search](https://cdn.adguardvpn.com/content/kb/vpn/ios/search-en.png) + +1. Select *AdGuard VPN - Unlimited & Fast* from the list of suggested applications and tap *Download*. If necessary, enter your Apple ID account password in the opened window. + + ![AdGuard VPN](https://cdn.adguardvpn.com/content/kb/vpn/ios/adguard-vpn-en.png) + +1. Wait for the download to finish and tap *Open*. AdGuard VPN for iOS has been successfully installed!