adguardteam / adguardknowledgebase Goto Github PK

https://gitter.im/AdguardHQ/AdguardKnowledgebase

https://kb.adguard.com/en/general/adguard-filter-policy

It does not cover language-specific filters.
It does not cover "Filter for useful ads".
It does not cover "Annoyances filter".

Change "Anti-adblock scripts will be blocked only if they limit functionality of the website or interfere in its use." to "Anti-adblock scripts will be blocked if they provide no alternative to disabling an ad blocker".

https://kb.adguard.com/en/android/faq

https://github.com/gshumihin/test/blob/master/xiaomi_issuefix.md

For Nougat case:
AdguardTeam/AdguardForAndroid#979

Ideally, I'd like to have it as a blog post.

Mixed approach:

1. Enable simplified domain names filter
2. Disable Adguard for all apps except browsers and DNS (and maybe Anrdoid OS -- we should test it).
3. Enable "Filter DNS requests"
4. Enable HTTPS filtering.

So, in-app ads will be blocked by the DNS filtering, and in-browser ads will be nicely blocked by default filtering.

We should ask people to try it and give their feedback. If they like it, we might add a simple switch for enabling this filtering mode.

Now we just have a section title there;
https://kb.adguard.com/en/windows

It'd be much better to have a TOC.

https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#basic-rules-special-characters

We should add one more sentence to ^ description:

The end of the address is also accepted as separator.

AdguardTeam/AdguardForWindows#1411

The same as we have on our blog:
https://blog.adguard.com/en/adguard-beta-test/

Talking about this page:
https://adguard.com/en/whitelist.html

1. You should also change the page content. Please find the article plan below.
2. Add a redirect from the website to the knowledge base.

Useful ads

Disclaimer it has nothing to do with the acceptable ads program, we don't take money for it.

We unblock only websites' self-promotion and search ads.
This is voluntary, you can choose either to block or not block this kind of ads.

What is search ads and why we consider it useful?

Contextual advertising in search engines helps you to find what you are looking for. The credibility of these ads is often higher than that of organic search results. This is because all the contextual ads have been manually moderated.

TODO: Add more arguments

What is websites self-promotion?

TODO: Describe what it is. For instance, promotion of the websites' own products. Link Adguard's filters policy, it is stated there that websites self-promotion should not be blocked on purpose.

What ads are on the list?

Search engines: Google, Yahoo, Bing, Ask, Yandex, DuckDuckGo.
TODO: We should also add startpage.com to the list.

Summary

https://kb.adguard.com/index.php?/Tickets/Submit

https://forum.adguard.com/index.php?threads/does-adguard-for-ios-support-extended-css-selectors.19204/#post-125470

Hints description:
AdguardTeam/AdguardFilters#3708 (comment)
AdguardTeam/AdguardFilters#5073

https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters

AdguardTeam/AdguardBrowserExtension#685

https://kb.adguard.com/en/windows/solving-problems/connection-not-trusted

i.e.: add info for rare browsers with no easy way to get to certificate manager: AdguardTeam/AdguardForWindows#1682

https://kb.adguard.com/en/macos/installation
https://kb.adguard.com/ru/macos/installation

The content is already available here:
https://adguard.com/en/how-to-delete-adguard.html#howForMac

Read this forum thread:
http://forums.macrumors.com/threads/the-ios-9-content-blocker-thread.1916783/page-116#post-24077973

Have to add an article to clarify on this:

AdguardTeam/AdguardForWindows#1701

https://kb.adguard.com/en/android/solving-problems/logcat

This type of info available only for Android - https://kb.adguard.com/en/android/solving-problems/log

Just like this one:
https://github.com/AdguardTeam/AdguardFilters/wiki/Android

1. How can user record requests log?
2. What's inside of that log?
3. How to get this log file for analysis (getting it from the device, using logcat for real-time analysis)

We also need to tell more about HAR files recording feature and how to analyze them.

Process priorities: background, foreground, etc.

Important thing to note:

@ameshkov if you use rules, contains ipv6, you should use "collapsed" syntax, e.g. use rule
[2001:4860:4860::8888]$network instead of [2001:4860:4860:0:0:0:0:8888]$network

Xiaomi https://github.com/gshumihin/test/blob/master/xiaomi_issuefix.md
Meizu
Huawei

On OnePlus you might need to “pin” AdGuard on the recent apps screen. This prevents OnePlus from killing it: AdguardTeam/AdguardForAndroid#1385

Prepare a table looking like:
Old article link -----> new article link

Change logo
Add language switcher

We should re-write the whole page.

Simple plan:

1. What is a userscript?
2. List of the recommended userscripts.
3. Where can I find more userscripts?
4. How can I develop my own userscripts?

AdguardTeam/AdguardForAndroid#985

I would either suggest creating more repositories for the other websites (blog/aff/mobile/main/forum/etc...) or ( whats the best solution IMO make this repo more general (like AdguardTeam/AduardWebsite for example) and create badges for the different subsites.

• Main
• Mobile
• Forum
• Affiliate

https://kb.adguard.com/ru/general/why-is-adguard-better

Do we still use it? If so, can we please add this to the kb or if we don't, remove the info from the official site

https://forum.adguard.com/index.php?threads/%D0%92%D0%BE%D0%BF%D1%80%D0%BE%D1%81.6/page-31#post-120436

browser://flags/#warn-for-unknown-root

This is an old article:
https://kb.adguard.com/index.php?/Knowledgebase/Article/View/28/0/what-to-do-if-you-suspect-infection

We should use information from this forum thread:
https://forum.adguard.com/index.php?threads/how-to-remove-adware-and-malware-self-help.17578/

https://kb.adguard.com/

1. Policy link should lead to KB
2. There should be a link to Adguard's github repo, so that people could report issues there

Talking about this:
https://kb.adguard.com/ru/android/solving-problems/adguard-outbound-proxy

First, we should give some general advice there.
Then, we should have a section for every known provider.

How to use Adguard with Tor
How to use Adguard with PIA (Private Internet Access)
How to use Adguard with Torguard

More or less detailed Windows/Mac/Android
For others - just copy/paste description from the website.

This is a new feature of the "Stealth Mode" module.

List of parameters being removed:

            "utm_source",
            "utm_medium",
            "utm_term",
            "utm_content",
            "utm_campaign",
            "utm_referrer",
            "yclid",
            "gclid",
            "_openstat",
            "fb_action_ids",
            "fb_comment_id",
            "fb_action_types",
            "fb_ref",
            "fb_source",
            "action_object_map",
            "action_type_map",
            "action_ref_map"

Helpful links:

• https://en.wikipedia.org/wiki/UTM_parameters
• https://developers.facebook.com/docs/games/services/measurement#referraltracking
• http://fbdevwiki.com/wiki/Ref

Known issues:

1. Headings of the same size.
2. No screenshots (prepare a simple instruction on how to take nice screenshots).

http://4pda.ru/forum/index.php?showtopic=601691&st=8760#entry60982649
http://4pda.ru/forum/index.php?showtopic=601691&st=8820#entry61172680

We should also mention that for proxy filtering mode one might need to block IPv6

We should update status of the TLSv1.3 issue according to this comment: AdguardTeam/AdguardForWindows#1737 (comment)

Sometimes we need to add a simple rule for blocking a single URL, but KB have no examples for trivial cases.
I think we should start 'Basic rules' page with a list of trivial cases.