Skip to content

Commit

Permalink
Merge pull request #553 from AdguardTeam/typos-and-formatting-fixes
Browse files Browse the repository at this point in the history
another iteration of fixes
  • Loading branch information
el-termikael authored Aug 23, 2024
2 parents 3ab1dcc + bed526a commit 5b27f5c
Show file tree
Hide file tree
Showing 36 changed files with 87 additions and 87 deletions.
4 changes: 2 additions & 2 deletions docs/adguard-for-android/features/settings.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ Under *App and filter updates*, you can configure automatic filter updates and s

*Watchdog* helps protect AdGuard from being disabled by the system ([read more about Android's battery save mode](/adguard-for-android/solving-problems/background-work/)). The value you enter will be the interval in seconds between watchdog checks.

*Logging level* defines what data about the app's operation should be logged. By default, the app collects the data about its events. The *Debug* level logs more events — enable it if asked by the AdGuard team to help them get a better understanding of the problem. [Read more about collecting and sending logs](/adguard-for-android/solving-problems/log/)
*Logging level* defines what data about the app's operation should be logged. By default, the app collects the data about its events. The *Debug* level logs more events — enable it if asked by the AdGuard team to help them get a better understanding of the problem. [Read more about recording and sending logs](/adguard-for-android/solving-problems/log/)

![Advanced *mobile_border](https://cdn.adtidy.org/blog/new/vshfnadvanced.png)

Expand Down Expand Up @@ -59,7 +59,7 @@ If you activate too many filters, some websites may work incorrectly.

### Userscripts

Userscripts are mini-programs written in JavaScript that extend the functionality of one or more websites. To install a userscripts, you need a special userscript manager. AdGuard has such a functionality and allows you to add userscripts by URL or from file.
Userscripts are miniprograms written in JavaScript that extend the functionality of one or more websites. To install a userscripts, you need a special userscript manager. AdGuard has such a functionality and allows you to add userscripts by URL or from file.

![Userscripts *mobile_border](https://cdn.adtidy.org/blog/new/isv6userscripts.png)

Expand Down
10 changes: 5 additions & 5 deletions docs/adguard-for-android/solving-problems/har.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: How to get HAR files
title: How to generate HAR files
sidebar_position: 5
---

Expand All @@ -17,11 +17,11 @@ HAR files are processed in accordance with [the AdGuard Privacy Policy](https://

## What are HAR files?

The HAR (HTTP ARchive) format is a JSON-formatted archive file for logging of a web browser's interaction with a site. The specifications of HAR format defines an archival data for HTTP transactions that used by a browser to export detailed information about web pages it loads. More detailed description of HAR file format and its specification you can find at [softwareishard.com](http://www.softwareishard.com/blog/har-12-spec/) website.
The HAR (HTTP ARchive) format is a JSON-formatted archive file for logging of a web browser's interaction with a site. The specifications of HAR format define archival data for HTTP transactions that a browser uses to export detailed information about the web pages it loads. More detailed description of HAR file format and its specification you can find at [softwareishard.com](http://www.softwareishard.com/blog/har-12-spec/) website.

## How to get HAR files
## How to generate HAR files

Sometimes we need to analyze it to block specific ads that are difficult to reproduce for some reason. To get HAR files follow these steps:
Sometimes we need to analyze it to block specific ads that are difficult to reproduce for some reason. To get HAR files, follow these steps:

1. Open AdGuard and go to **Settings** (⚙ icon in the lower right corner).
2. Tap **General****Advanced****Low-level settings**.
Expand All @@ -31,7 +31,7 @@ Sometimes we need to analyze it to block specific ads that are difficult to repr
6. Go back to **Advanced**.
7. Tap **Export logs and system info****Allow** (if necessary) → **Save**.

**Please send the file with logs (that you've got as a result) to the AdGuard support service.**
**Send the generated file with the logs to the AdGuard support service.**

:::note

Expand Down
8 changes: 4 additions & 4 deletions docs/adguard-for-android/solving-problems/log.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: How to collect debug logs
title: How to record debug logs
sidebar_position: 2
---

Expand All @@ -15,17 +15,17 @@ Data and/or files provided in logs are processed in accordance with [the AdGuard

:::

In this article, we'll guide you through the process of collecting debug logs, an essential troubleshooting step for solving complex issues that may potentially arise. Debug logs provide detailed insight into the inner workings of AdGuard for Android. If the AdGuard support team asks you to provide debug logs, simply follow these instructions.
In this article, we'll guide you through the process of recording debug logs, an essential troubleshooting step for solving complex issues that may potentially arise. Debug logs provide detailed insight into the inner workings of AdGuard for Android. If the AdGuard support team asks you to provide debug logs, simply follow these instructions.

:::note

AdGuard is committed to protecting your privacy. We strictly follow our [Privacy Policy](https://adguard.com/privacy/android.html) and do not collect any private information about users. Before sending your logs to the support team, please review the file as it may contain additional information that you don’t want to share. If it contains such personal information, we recommend that you delete it first.

:::

### Collecting debug log
### Recording debug log

To collect **debug** log and send it to us you need to perform following steps:
To record **debug** log and send it to us, you need to perform following steps:

1. Go to *Settings**General**Advanced*.
1. Tap *Logging level* and set it to *Debug*.
Expand Down
2 changes: 1 addition & 1 deletion docs/adguard-for-android/solving-problems/logcat.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ Data and/or files provided in logs are processed in accordance with [the AdGuard

:::

Sometimes a regular log may not be sufficient to identify the origin of the problem. In such cases a system log is needed. Below are instructions on how to collect and get it: via Developer options and Logcat.
Sometimes a regular log may not be sufficient to identify the origin of the problem. In such cases a system log is needed. Below are instructions on how to get it: via Developer options and Logcat.

:::note

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -114,7 +114,7 @@ Use it only for debugging purposes!

#### Encrypted Client Hello

Every encrypted Internet connection has an unencrypted part. This is the very first packet which contains the name of the server you are connecting to. Encrypted Client Hello technology is supposed to solve this issue and encrypt that last bit of unencrypted information. To benefit from it, enable the *Encrypted Client Hello* option. It uses a local DNS proxy to look for the ECH configuration for the domain. If it is found, ClientHello packet will be encrypted.
Every encrypted Internet connection has an unencrypted part. This is the very first packet which contains the name of the server you are connecting to. Encrypted Client Hello technology is supposed to solve this issue and encrypt that last bit of unencrypted information. To benefit from it, enable the *Encrypted Client Hello* option. It uses a local DNS proxy to look for the ECH configuration for the domain. If it is found, Client Hello packet will be encrypted.

#### OCSP checking

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ This article is about AdGuard for Android, a multifunctional ad blocker that pro

:::

To be able to [filter HTTPS traffic](/general/https-filtering/what-is-https-filtering.md) (which is extremely important as most ads use HTTPS), AdGuard needs to install a certificate into your device's user storage. On older versions of the Android OS this was done automatically, but on Android 11 and later users have to install it manually.
To be able to [filter HTTPS traffic](/general/https-filtering/what-is-https-filtering.md) (which is extremely important as most ads use HTTPS), AdGuard needs to install its certificate into your device's user storage. On older versions of the Android OS this was done automatically, but on Android 11 and later users have to install it manually.

![Certificate *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/android/solving_problems/manual-certificate/g.gif)

Expand Down
6 changes: 3 additions & 3 deletions docs/adguard-for-ios/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ AdGuard for iOS is an app presented in the App Store. To install it on your devi

![On the App Store main screen, tap Search *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/installation/iOS/en/1.png)

Type *adguard* in the search bar and tap the string *adGuard* which will be among search results.
Type *adguard* in the search bar and tap the string *AdGuard* which will be among search results.

![Type "AdGuard" in the search bar *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/installation/iOS/en/2.png)

Expand All @@ -43,11 +43,11 @@ AdGuard Pro is a paid version of AdGuard for iOS, offering an expanded set of fu

![On the App Store main screen, tap Search *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/installation/iOS/en/1.png)

Type *adguard* in the search form, and then tap the string *adGuard pro - adblock* which will be shown among search results.
Type *adguard* in the search form, and then tap the string *AdGuard Pro — adblock* which will be shown among search results.

![Type "AdGuard" in the search bar *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/installation/iOS/en/2.png)

On the opened page of the App Store tap the button with the cost of the license under the string *AdGuard Pro - adblock*, and then tap *BUY*. You may be requested to enter your Apple ID login and password. Type it in and wait for the installation to complete.
On the opened page of the App Store tap the button with the cost of the license under the string *AdGuard Pro adblock*, and then tap *BUY*. You may be requested to enter your Apple ID login and password. Type it in and wait for the installation to complete.

![Tap GET below the AdGuard app *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/installation/iOS/en/3.png)

Expand Down
4 changes: 2 additions & 2 deletions docs/adguard-for-ios/solving-problems/low-level-settings.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,9 +25,9 @@ To go to *Low-level settings*, tap the gear icon at the bottom right of the scre

There are two main tunnel modes: *Split* and *Full*. *Split-Tunnel* mode provides compatibility of AdGuard and so-called "Personal VPN" apps. In *Full-Tunnel* mode no other VPN can work simultaneously with AdGuard.

There is a specific feature of *Split-Tunnel* mode: if DNS proxy does not perform well, for example, if the response from the AdGuard DNS server was not returned in time, iOS will "amerce" it and reroute traffic through DNS server, specified in iOS settings. No ads are blocked at this time and DNS traffic is not encrypted.
There is a specific feature of the *Split-Tunnel* mode: In case of poor DNS proxy performance, for example, if the response from the AdGuard DNS server isn't returned in timely, iOS will instead reroute traffic through the DNS server specified in the iOS settings. No ads are blocked at this time and DNS traffic is not encrypted.

In *Full-Tunnel* mode only the DNS server specified in AdGuard settings is used. If it does not respond, the Internet will simply not work. Enabled *Full-Tunnel* mode may cause the incorrect performance of some programs (for instance, Facetime), and lead to problems with app updates.
In *Full-Tunnel* mode only the DNS server specified in AdGuard settings is used. If it does not respond, the Internet will simply not work. Enabled *Full-Tunnel* mode may negatively impact the performance of some programs (e.g., FaceTime) and cause app update issues.

By default, AdGuard uses *Split-Tunnel* mode as the most stable option.

Expand Down
2 changes: 1 addition & 1 deletion docs/adguard-for-mac/solving-problems/advanced-settings.md
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,7 @@ Time, in seconds, before sending another keepalive probe to an unresponsive peer

#### `network.https.ech.enabled`

Uses a local DNS proxy to look for configs in the ECH Config Lists. If found, encrypts ClientHellos.
Uses a local DNS proxy to look for configs in the ECH Config Lists. If found, encrypts Client Hellos.

#### `network.https.enforce.certificate.transparency`

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ This article is about AdGuard for Mac, a multifunctional ad blocker that protect

:::

During the Installation of AdGuard on macOS High Sierra (or later versions) you may see a message: "System Extension Blocked". This is a new security mechanism that appeared in High Sierra, it requires you to explicitly allow the installation of a third-party system extension. To complete the installation of AdGuard you have to manually allow loading the extension in *System Preferences**Security & Privacy**General*.
During the installation of AdGuard on macOS High Sierra (or later), you may see this message: "System Extension Blocked". This is a new security mechanism that appeared in High Sierra, it requires you to explicitly allow the installation of a third-party system extension. To complete the installation of AdGuard you have to manually allow loading the extension in *System Preferences**Security & Privacy**General*.

![Allow extension installation in settings](https://cdn.adtidy.org/public/Adguard/kb/PicturesEN/highsierra.png)

Expand Down
2 changes: 1 addition & 1 deletion docs/adguard-for-safari/features/about.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,6 @@ In the About tab, you can see info about the current version of your product and

:::note Reminder

AdGuard for Safari can be downloaded for free [from the App Store](https://apps.apple.com/app/adguard-for-safari/id1440147259). A detailed setup instruction is available in the [Knowledge base](/adguard-for-safari/installation/).
AdGuard for Safari can be downloaded for free [from the App Store](https://apps.apple.com/app/adguard-for-safari/id1440147259). A detailed setup instruction is available in the [Knowledge Base](/adguard-for-safari/installation/).

:::
6 changes: 3 additions & 3 deletions docs/adguard-for-safari/solving-problems/logs.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: How to collect logs in AdGuard for Safari
title: How to record logs in AdGuard for Safari
sidebar_position: 4
---

Expand All @@ -9,9 +9,9 @@ This article is about AdGuard for Safari, which safeguards only your Safari brow

:::

To analyze and diagnose various problems that may occur with AdGuard for Safari, the AdGuard support service may need its log files. These files contain records of errors and other software events. Below are brief instructions on how to collect logs and send them to support if necessary.
To analyze and diagnose various problems that may occur with AdGuard for Safari, the AdGuard support service may need its log files. These files contain records of errors and other software events. Below are brief instructions on how to record logs and send them to support if necessary.

### How to collect logs
### How to record logs

1. Open AdGuard for Safari app.
2. Scroll down and click *Export logs*.
Expand Down
6 changes: 3 additions & 3 deletions docs/adguard-for-windows/features/extensions.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,19 +29,19 @@ AdGuard Assistant is Legacy Assistant that you may use if the [new Assistant](/a

This is a custom extension designed to fight the technique of re-inserting blocked ads — the so-called ad blocker circumvention/ad reinjection. Both are advanced anti-ad blocker methods that continue to rise in popularity among advertisers.

AdGuard Extra is essentially a mini-program that changes the way pages work in such a way that it becomes much more difficult for sites to use the above-mentioned methods to bypass blockers.
AdGuard Extra is essentially a miniprogram that changes the way pages work in such a way that it becomes much more difficult for sites to use the above-mentioned methods to bypass blockers.

**AdGuard Popup Blocker**

This extension prevents popup windows from opening when you view web pages. Some pop-ups are considered useful — they may contain settings for site administering or additional reference information demonstrated upon clicking a link. That is why you can turn off the Blocker if needed. This extension doesn’t work on websites added to the AdGuard exceptions list either. It is turned off by default, but you can turn it on in the application settings. You will find more detailed information about this extension in our Knowledge base.
This extension prevents popup windows from opening when you view web pages. Some pop-ups are considered useful — they may contain settings for site administering or additional reference information demonstrated upon clicking a link. That is why you can turn off the Blocker if needed. This extension doesn’t work on websites added to the AdGuard exceptions list either. It is turned off by default, but you can turn it on in the application settings. You will find more detailed information about this extension in our Knowledge Base.

**Web of Trust**

Web of Trust lets you see the reputation of each website based on its users’ opinions. The site is rated by a number of specific criteria: trust, security, etc. This extension is turned off by default, but you can turn it on in the application settings. Please, note that AdGuard is not the developer of this extension.

### Network

The penultimate module is dedicated to network filtering, and here you will find additional network-related options. Two of them are enabled by default: *Enable traffic filtering* and *Filter HTTPS*. These are important extra precautions to better filter your web space. Most websites are now using HTTPS, and the same applies to advertising. From many sites, like youtube.com, facebook.com and twitter.com, it is impossible to remove ads without HTTPS filtering. So keep the *Filter HTTPS* feature enabled unless you have a strong reason not to.
The penultimate module is dedicated to network filtering, and here you will find additional network-related options. Two of them are enabled by default: *Enable traffic filtering* and *Filter HTTPS*. These are important extra precautions to better filter your web space. Most websites are now using HTTPS, and the same applies to advertising. From many sites, like youtube.com, facebook.com and x.com, it is impossible to remove ads without HTTPS filtering. So keep the *Filter HTTPS* feature enabled unless you have a strong reason not to.

![Network Settings *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/network-settings.png)

Expand Down
Loading

0 comments on commit 5b27f5c

Please sign in to comment.