el1t · geoffdutton · May 16, 2017 · May 17, 2017 · Jan 13, 2018 · Jan 13, 2018
diff --git a/.github/ISSUE_TEMPLATE.md b/.github/ISSUE_TEMPLATE.md
@@ -1,32 +1,33 @@
-> Filter issues **MUST NOT** be reported here. Read first: <https://github.com/gorhill/uBlock/blob/master/CONTRIBUTING.md>
+<!-- Filter issues **MUST NOT** be reported here. Read first: <https://github.com/gorhill/uBlock/blob/master/CONTRIBUTING.md> -->
 
 ### Describe the issue
 
 
 ### One or more specific URLs where the issue occurs
 
-> [URL(s) for issue on a specific site are **mandatory**]
+<!-- URL(s) for issue on a specific site are **mandatory** -->
 
 ### Screenshot in which the issue can be seen
 
-> [Screenshot(s) for visual issues are **mandatory**]
+<!-- Screenshot(s) for visual issues are **mandatory** -->
 
 ### Steps for anyone to reproduce the issue
 
-1. Be as detailed as possible:
-1. Because we are not looking over your shoulder and
-1. Keep in mind: Nobody can read your mind.
+<!-- 1. Do this
+2. Then do this
+3. Observe this
+4. Etc. -->
 
 ### Your settings
 
-> [If you fail to provide this info, I will mark the issue as invalid. Lists all settings which differs from default settings]
+<!-- If you fail to provide this info, I will mark the issue as invalid. Lists all settings which differs from default settings -->
 
 - MacOS version: 
 - Safari version: 
 - uBlock Origin version: 
 
 ##### Your filter lists
 
-> [Example: "Default filter lists + FRA", or "Default filter lists minus uBlock -- Badware risks"]
+<!-- Example: "Default filter lists + FRA", or "Default filter lists minus uBlock -- Badware risks" -->
 
 ##### Your custom filters (if any)
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -1,83 +1,20 @@
 # Submitting issues
 
-From now on, I will be quite less inclined to deal with issues for which little to no investigation to find the **actual cause** of a purported issue was made by the reporter. Positive contributions are those which are reported with efforts to find the actual cause of an issue, or at the very least efforts were made to narrow it as much as possible. This project is a hobby, do not expect "customer support"-style interaction. Requiring people to investigate as much as possible before opening an issue will more than likely avoid burdening the project with [invalid issues](https://github.com/gorhill/uBlock/issues?q=is%3Aissue+is%3Aclosed+label%3Ainvalid) or [issues unrelated](https://github.com/gorhill/uBlock/issues?q=is%3Aissue+is%3Aclosed+label%3Aexternal) to uBO.
+Despite all the guidelines and warnings I added over the years about how to use it, the GitHub issue tracker always end up being used as a [help desk](https://en.wikipedia.org/wiki/Help_desk) rather than a place to report actual, real and proven issues.
 
-For **support/discussions/help**, there is [/r/uBlockOrigin](https://www.reddit.com/r/uBlockOrigin/) on Reddit -- this is where I see the most activity for people helping each other regarding uBlock Origin.
+Typically help desk are best handled by enthusiast volunteers -- so hopefully this is what will happen.
 
-For **filter-related issues**, report on the respective filter list support site, or at [uBlockOrigin/uAssets](https://github.com/uBlockOrigin/uAssets/issues). Use [the logger](https://github.com/gorhill/uBlock/wiki/The-logger) to diagnose/confirm filter-related issues. If something does not work properly with uBO enabled, the **first step** is to rule out filter-related issues.
+Given this, from now on I will consider GitHub issue tracker as a help desk one for uBlock Origin. I unsubscribed from being notified from all issues being opened, I will visit once in a while as time and mood allow.
 
-Ignorance of the above rules is no excuse: **Opening an issue for purpose of support or discussion, or opening a filter-related issue will result in the user being immediately blocked.** Given the [amount of invalid issues being opened](https://github.com/gorhill/uBlock/issues?q=is%3Aissue+label%3Ainvalid+is%3Aclosed), I have no choice but to resort to such a drastic measure. You will still be able to open filter list issues at [uBlockOrigin/uAssets](https://github.com/uBlockOrigin/uAssets/issues).
+When I will be visiting the "help desk", I will focus **only** on issues which I have good reasons to believe to be valid issues with uBlock Origin **itself**.
 
-**The issue tracker is for provable issues only:** You will have to make the case that the issue is really with uBlock Origin and not something else on your side. To make a case means to provide detailed steps so that anybody can reproduce the issue. Be sure to rule out that the issue is not caused by something specific on your side. Specifically, _speculated_ performance issues will be marked as invalid and closed if they do not come with **actual profiling data + analysis** supporting the claim.
+Valid issues typically comes with minimal but detailed steps to reproduce (i.e. no guesswork whatsoever required for others to reproduce), and especially genuine efforts to investigate the cause of an issue **as far as possible** using all the browser tools (uBO is HTML/CSS/JS, the browser has all the tools to investigate all of this). These will have my attention, and I will address them.
 
-**Any issue opened without effort to provide the required details for me (or anybody else) to reproduce the problem will be closed as _invalid_.** If you provide more details thereafter for me to reproduce the issue, I will reopen it if I can confirm there is indeed an issue with uBlock Origin. Example of detailed steps:
-
-> 1. browser version/ublock version
-> 1. these settings, these filter lists, these custom filters.
-> 1. do this.
-> 1. open this exact URL.
-> 1. do this.
-> 1. observe this.
-> 1. click this.
-> 1. observe such and such issue
-> 1. see screenshot
-> 1. etc.
-
-The most important part when opening an issue: **detailed steps**.
-
-**Important:** I simply do not have the time to take care of filter-related issues, you will have to find help elsewhere for this. The mere need to have to respond to filter-related issues can quickly become a burden. Consider that writing code/doc occupies all my free time. Surely there are other people out there ready to help with filter-related issues, it does not have to be me.
-
-***
-
-### Before you submit
-
-1. Submit **bugs/issues only**.
-    - Bugs occur, I will fix them.
-1. _One specific_ issue per submission.
-1. The logger is the tool of choice to use to help diagnose issues.
-1. Do **NOT**:
-    - Submit pull requests.
-    - Submit design ideas.
-    - Submit feature requests.
-    - Submit "revolutionary ideas".
-    - Post comments like "+1" or "me too!" without providing new relevant info on the issue.
-    - Use issues as replacement for threads on a bulletin board.
-    - Any such issue will be closed without comment.
-    - Ask me to publish the latest version to AMO/Chrome store: In all likelihood it is already published, but pending review, something which is out of my control.
-1. Make sure your issue [hasn't already been fixed in a recent release](https://github.com/gorhill/uBlock/releases).
-1. Verify that the issue does **not** occur with uBlock disabled.
-1. **Verify that the issue is not related to a 3rd-party filter lists.**
-    - Issues with 3rd-party filter lists are the responsibility of their respective maintainers.
-1. Verify that the issue is not caused by another extension.
-1. Do not submit issues which can be reproduced **only** on Chrome Canary or Firefox Nightly: these are not stable browser versions and in all likelihood, whatever issue is not within uBO.
-    - Report **only** if you can reproduce in an official stable release, or a beta release.
+In case I am really needed for a given issue, you can mention me using `@gorhill` so that GitHub will notify me.
 
 ***
 
-### What to include
-
-To help diagnose and fix the bug/issue, please always include the following in your report:
-
-* A clear list of steps to reproduce the problem
-  * **ALWAYS INCLUDE A SPECIFIC URL WHERE THE ISSUE OCCURS**, _even_ if "it happens everywhere".
-* Symptoms of the issue
-  * Describe what you observe and consider broken behavior; this is what we'll be looking for after executing the steps
-  * Example: video doesn't start playing, page layout broken
-* Include whatever relevant the logger reports.
-* A screenshot or transcription of **any of uBlock's preferences that differ from the defaults**
-  * This includes a whitelisted website, enabled/disabled filter list, anything
-  * Please do include everything different from the defaults whether or not it seems relevant to your issue
-* The version of uBlock Origin you're having the issue with; you can find this in [uBlock's popup UI](https://github.com/gorhill/uBlock/wiki/Quick-guide:-popup-user-interface)
-  * Example: `uBlock 1.10.0`
-* The Safari version you're using
-  * Examples: `Safari 10.0.1`, `Safari TP 18` 
-* The MacOS version you're using
-  * Examples: `MacOS Sierra 10.12.1`, `OSX 10.10.5`
-* A list of other extensions you have installed
-  * Tip: try disabling them and see if your issue still occurs
-
-Otherwise, we've noticed that a lot of **your** time (and the developers') gets thrown away on exchanging back and forth to get this information.
-
-***
+Good readings:
 
-**Good read:** [How to Report Bugs Effectively](http://www.chiark.greenend.org.uk/~sgtatham/bugs.html).
+- [How to Report Bugs Effectively](http://www.chiark.greenend.org.uk/~sgtatham/bugs.html)
+- [Why I didn’t fix your bug](http://magnusmanske.de/wordpress/?p=518)
diff --git a/assets/assets.json b/assets/assets.json
@@ -424,7 +424,7 @@
 		"off": true,
 		"title": "IRN: Adblock-Iran",
 		"lang": "fa",
-		"contentURL": "https://raw.githubusercontent.com/farrokhi/adblock-iran/master/filter.txt",
+		"contentURL": "https://cdn.rawgit.com/farrokhi/adblock-iran/master/filter.txt",
 		"supportURL": "https://github.com/farrokhi/adblock-iran"
 	},
 	"ISL-0": {
@@ -526,23 +526,36 @@
 		"contentURL": "https://easylist-downloads.adblockplus.org/easylistdutch.txt",
 		"supportURL": "https://forums.lanik.us/viewforum.php?f=100"
 	},
+	"NOR-0": {
+		"content": "filters",
+		"group": "regions",
+		"off": true,
+		"title": "NOR: Dandelion Sprouts norske filtre",
+		"lang": "nb",
+		"contentURL": "https://raw.githubusercontent.com/DandelionSprout/adfilt/master/ExperimentalNorwegianList.txt",
+		"supportURL": "https://github.com/DandelionSprout/adfilt"
+	},
 	"POL-0": {
 		"content": "filters",
 		"group": "regions",
 		"off": true,
 		"title": "POL: polskie filtry do Adblocka i uBlocka",
 		"lang": "pl",
 		"contentURL": "https://raw.githubusercontent.com/MajkiIT/polish-ads-filter/master/polish-adblock-filters/adblock.txt",
-		"supportURL": "https://github.com/MajkiIT/polish-ads-filter/issues"
+		"supportURL": "https://github.com/MajkiIT/polish-ads-filter/issues",
+		"instructionURL": "https://github.com/MajkiIT/polish-ads-filter#polish-filters-for-adblock-ublock-origin--adguard"
 	},
-	"POL-1": {
+	"ROU-1": {
 		"content": "filters",
 		"group": "regions",
 		"off": true,
-		"title": "POL: polskie filtry do uBlocka uzupelnienie",
-		"lang": "pl",
-		"contentURL": "https://raw.githubusercontent.com/MajkiIT/polish-ads-filter/master/polish-adblock-filters/adblock_ublock.txt",
-		"supportURL": "https://github.com/MajkiIT/polish-ads-filter/issues"
+		"title": "ROU: Romanian Ad (ROad) Block List Light",
+		"lang": "ro",
+		"contentURL": [
+			"https://road.adblock.ro/lista.txt",
+			"https://raw.githubusercontent.com/tcptomato/ROad-Block/master/road-block-filters-light.txt"
+		],
+		"supportURL": "https://github.com/tcptomato/ROad-Block"
 	},
 	"RUS-0": {
 		"content": "filters",

diff --git a/dist/description/description-fa.txt b/dist/description/description-fa.txt
@@ -2,11 +2,11 @@
 
 بررسی تصویری از کارایی این محصول: https://github.com/gorhill/uBlock/wiki/uBlock-vs.-ABP:-efficiency-compared
 
-کاربرد: دکمه ی پاور بزرگ در پنجره برای فعال یا غیر فعال کردن uBlock برای صفحه ی جاری است. فقط برای همین سایت اعمال میشود، دکمه ی پاوری برای تمام سایت ها نیست.
+روش استفاده: دکمۀ قدرت بزرگ در پنجرۀ بالاپَر برای فعال یا غیرفعال کردن دائمی یوبلاک برای وب‌سایت فعلی می‌باشد. این فقط برای همین سایت اعمال میشود، این دکمه ی قدرتی برای تمام سایت ها نیست.
 
 ***
 
-انعطاف پذیری آن بیشتر از "ad blocker" است: همچنین می تواند فیلتر ها را از هاست میزبان، بخواند و بسازد.
+انعطاف پذیری آن بیشتر از "ad blocker" است: این یکی همچنین می تواند فیلتر‌هایی را از فایل‌های هاست‌های میزبان، خوانده و بسازد.
 
 بیرون از جعبه، این لیست فیلترها بارگذاری و اجرا میشوند:
 

diff --git a/dist/description/description-ka.txt b/dist/description/description-ka.txt
@@ -1,49 +1,49 @@
-An efficient blocker: easy on memory and CPU footprint, and yet can load and enforce thousands more filters than other popular blockers out there.
+რეკლამების შედეგიანი შემზღუდავი: მეხსიერებისა და პროცესორის შემსუბუქებული მოხმარება, რეკლამების სხვა შემზღუდავებთან შედარებით, ათასობით მეტი ფილტრის გამოყენების პირობებშიც კი.
 
-Illustrated overview of its efficiency: https://github.com/gorhill/uBlock/wiki/uBlock-vs.-ABP:-efficiency-compared
+შედეგიანობის მიმოხილვა იხილეთ ბმულზე: https://github.com/gorhill/uBlock/wiki/uBlock-vs.-ABP:-efficiency-compared
 
-Usage: The big power button in the popup is to permanently disable/enable uBlock for the current web site. It applies to the current web site only, it is not a global power button.
+გამოყენება: ჩართვის დიდი ღილაკით, ჩამოშლილ მენიუში, შესაძლებელია uBlock-ის ჩართვა/გამორთვა მიმდინარე ვებსაიტზე. ეს ღილაკი მოქმედებს მხოლოდ არსებულ საიტზე და არ გამოიყენება ზოგადად ჩართვა/გამორთვისთვის.
 
 ***
 
-Flexible, it's more than an "ad blocker": it can also read and create filters from hosts files.
+მეტად მოქნილი, ეს არაა უბრალოდ „რეკლამების შემზღუდავი“: ასევე შესაძლებელია hosts ფაილის წაკითხვა და ფილტრების შექმნა.
 
-Out of the box, these lists of filters are loaded and enforced:
+გარდა ამისა, ნაგულისხმევად ჩართულია და გამოიყენება შემდეგი გასაფილტრი სიები:
 
 - EasyList
-- Peter Lowe’s Ad server list
+- Peter Lowe-ის სარეკლამო სერვერების სია
 - EasyPrivacy
-- Malware domains
+- მავნე დომენები
 
-More lists are available for you to select if you wish:
+ასევე, ხელმისაწვდომია სიები სურვილისამებრ შესარჩევად:
 
-- Fanboy’s Enhanced Tracking List
-- Dan Pollock’s hosts file
-- hpHosts’s Ad and tracking servers
+- Fanboy-ის გაუმჯობესებული სია თვალყურისმდევნებლების
+- Dan Pollock-ის hosts ფაილი
+- hpHosts-ის სარეკლამო და თვალყურისმდევნელი სერვერები
 - MVPS HOSTS
 - Spam404
-- And many others
+- და კიდევ ბევრი
 
-Of course, the more filters enabled, the higher the memory footprint. Yet, even after adding Fanboy's two extra lists, hpHosts’s Ad and tracking servers, uBlock still has a lower memory footprint than other very popular blockers out there.
+რასაკვირველია, რაც უფრო მეტი ფილტრია ჩართული, მეხსიერების გამოყენება იზრდება. თუმცა, Fanboy-ის გაფართოებული სიების, hpHosts-ის სარეკლამო და თვალყურისმდევნელი სერვერების დამატების შემთხვევაშიც კი, uBlock მაინც ნაკლებ მეხსიერებას იყენებს, ვიდრე ყველა სხვა ცნობილი შემზღუდავი პროგრამები.
 
-Also, be aware that selecting some of these extra lists may lead to higher likelihood of web site breakage -- especially those lists which are normally used as hosts file.
+ამასთან, გაითვალისწინეთ, რომ ზოგიერთი დამატებითი სიის შერჩევის შედეგად, შესაძლოა ვებსაიტები არ გამოჩნდეს გამართულად -- განსაკუთრებით იმ სიების შემთხვევაში, რომელიც ჩვეულებრივ, hosts ფაილად გამოიყენება.
 
 ***
 
-Without the preset lists of filters, this extension is nothing. So if ever you really do want to contribute something, think about the people working hard to maintain the filter lists you are using, which were made available to use by all for free.
+წინასწარ შედგენილ სიებს, მნიშვნელოვანი ადგილი უჭირავს ამ გაფართოების შედეგიან მუშაობაში. ასე რომ, თუ ოდესმე გადაწყვეტთ ვინმესთვის შემოწირულობის გაღებას, იფიქრეთ იმ ადამიანებზე, რომლებიც თავდაუზოგავად შრომობენ იმ გასაფილტრი სიების მუდმივ განახლებაზე, რომლითაც სარგებლობთ და რომელიც ხელმისაწვდომია ყველასთვის უფასოდ.
 
 ***
 
-Free.
-Open source with public license (GPLv3)
-For users by users.
+უფასო.
+ღია წყაროს მქონე საჯარო ლიცენზიით (GPLv3)
+მომხმარებლების მიერ, მომხმარებლებისთვის.
 
-Contributors @ Github: https://github.com/gorhill/uBlock/graphs/contributors
-Contributors @ Crowdin: https://crowdin.net/project/ublock
+წვლილის შემტანები @ Github: https://github.com/gorhill/uBlock/graphs/contributors
+წვლილის შემტანები @ Crowdin: https://crowdin.net/project/ublock
 
 ***
 
 It's quite an early version, keep this in mind when you review.
 
-Project change log:
+ცვლილებების ჩამონათვალი:
 https://github.com/gorhill/uBlock/releases