uBlock to uBlock Origin (and to uBO)

Does-uBlock-Origin-block-ads-or-just-hide-them?.md

@@ -0,0 +1,50 @@
+There are two kinds of [ABP-compatible filters](https://adblockplus.org/en/filters): network filters and cosmetic filters. _Cosmetic filters_ are referred to as _element hiding_ filters by Adblock Plus ("ABP").
+
+#### Network filters
+
+**Short answer:** resources blocked: network requests are cancelled before they leave the browser.
+
+The purpose of network filter is to prevent a network request to be made to a remote server, so as to prevent downloading a remote resource. uBlock Origin will prevent the network request from even being made. This saves bandwidth, decrease privacy exposure -- as the remote server won't be able to log anything if you do not contact it.
+
+#### Hosts file
+
+**Short answer:** resources blocked: network requests are cancelled before they leave the browser.
+
+uBlock Origin also support the parsing and enforcing of hosts files -- something which ABP does not. All entries in a hosts file are parsed as network filters, i.e. no resource will be fetch from a remote server which appear in a hosts file, no connection will even be attempted.
+
+![uBlock Origin blocks reliably](https://raw.githubusercontent.com/gorhill/uBlock/master/doc/img/ublock-blocks.gif)<br><sup>Blocked network requests are nipped in the bud.</sup>
+
+#### Cosmetic filters
+
+**Short answer:** resources hidden -- in various ways depending on the class of cosmetic filters.
+
+These filters serve to visually remove DOM elements from a web page. They have no value privacy-wise, it is essentially to make web page look better by removing unwanted content, which usually cannot be blocked using network filters. Just like ABP, uBlock Origin will hide DOM elements on a web page which match cosmetic filters. uBO uses a [different method](./Cosmetic-filtering-in-uBlock:-version-0.4.0.0-update) than other big-name blockers to hide the DOM elements though.
+
+Different classes of cosmetic filters are applied differently:
+
+- Specific cosmetic filters: injected before page's root DOM is loaded
+    - No flickering
+- Generic cosmetic filters: injected after page's root DOM is loaded
+    - These are cacheable
+    - Since these cosmetic filters are applied after page load, DOM elements **may** be hidden after they are rendered
+        - Notice the emphasized "may": generally, you won't see this: the slower the computer, the higher the likelihood
+        - Solution for when the behavior occurs and is an issue for a user: to create the appropriate specific cosmetic filter.
+- Cached generic cosmetic filters: injected before page's root DOM is loaded
+    - No flickering
+
+Also, a very simple test page to find out if cosmetic filtering can be bypassed in your blocker: <http://raymondhill.net/ublock/adbox.html>.
+
+#### More details regarding network filtering
+
+When a network request is filtered, **both** uBlock Origin and ABP will collapse the DOM counterpart -- if any -- of a blocked network request. They both work the same way in such scenario, in the absence of a cosmetic filter matching the DOM counterpart of a blocked network request.
+
+In **both** uBlock Origin and ABP, this occurs **after** the DOM is loaded, so in both cases, users **may** be able to visually notice the placeholder collapsing after the page loads.
+
+Yet, uBlock Origin is at an advantage in such case: since it does not inject thousands of CSS rules in a page (and frames within that page), this means it makes itself available sooner to handle the task of collapsing the DOM counterpart of blocked network requests. This can be clearly appreciated in the following [test page](http://raymondhill.net/ublock/tiles1.html):
+
+- Chromium + uBlock Origin: minimal flickering (sometimes none)
+- Chromium + ABP: noticeable flickering
+- Firefox + uBlock Origin: no flickering
+- Firefox + ABP: no flickering
+
+Another advantage of uBlock Origin here is that these collapsed-DOM-counterpart-of-blocked-network-requests are cached as temporary specific cosmetic filters internally.

Does-uBlock-block-ads-or-just-hide-them?.md

@@ -1,50 +0,0 @@
-There are two kinds of [ABP-compatible filters](https://adblockplus.org/en/filters): network filters and cosmetic filters. _Cosmetic filters_ are referred to as _element hiding_ filters by Adblock Plus ("ABP").
-
-#### Network filters
-
-**Short answer:** resources blocked: network requests are cancelled before they leave the browser.
-
-The purpose of network filter is to prevent a network request to be made to a remote server, so as to prevent downloading a remote resource. uBlock will prevent the network request from even being made. This saves bandwidth, decrease privacy exposure -- as the remote server won't be able to log anything if you do not contact it.
-
-#### Hosts file
-
-**Short answer:** resources blocked: network requests are cancelled before they leave the browser.
-
-uBlock also support the parsing and enforcing of hosts files -- something which ABP does not. All entries in a hosts file are parsed as network filters, i.e. no resource will be fetch from a remote server which appear in a hosts file, no connection will even be attempted.
-
-![uBlock blocks reliably](https://raw.githubusercontent.com/gorhill/uBlock/master/doc/img/ublock-blocks.gif)<br><sup>Blocked network requests are nipped in the bud.</sup>
-
-#### Cosmetic filters
-
-**Short answer:** resources hidden -- in various ways depending on the class of cosmetic filters.
-
-These filters serve to visually remove DOM elements from a web page. They have no value privacy-wise, it is essentially to make web page look better by removing unwanted content, which usually cannot be blocked using network filters. Just like ABP, uBlock will hide DOM elements on a web page which match cosmetic filters. uBlock uses a [different method](./Cosmetic-filtering-in-uBlock:-version-0.4.0.0-update) than other big-name blockers to hide the DOM elements though.
-
-Different classes of cosmetic filters are applied differently:
-
-- Specific cosmetic filters: injected before page's root DOM is loaded
-    - No flickering
-- Generic cosmetic filters: injected after page's root DOM is loaded
-    - These are cacheable
-    - Since these cosmetic filters are applied after page load, DOM elements **may** be hidden after they are rendered
-        - Notice the emphasized "may": generally, you won't see this: the slower the computer, the higher the likelihood
-        - Solution for when the behavior occurs and is an issue for a user: to create the appropriate specific cosmetic filter.
-- Cached generic cosmetic filters: injected before page's root DOM is loaded
-    - No flickering
-
-Also, a very simple test page to find out if cosmetic filtering can be bypassed in your blocker: <http://raymondhill.net/ublock/adbox.html>.
-
-#### More details regarding network filtering
-
-When a network request is filtered, **both** uBlock and ABP will collapse the DOM counterpart -- if any -- of a blocked network request. They both work the same way in such scenario, in the absence of a cosmetic filter matching the DOM counterpart of a blocked network request.
-
-In **both** uBlock and ABP, this occurs **after** the DOM is loaded, so in both cases, users **may** be able to visually notice the placeholder collapsing after the page loads.
-
-Yet, uBlock is at an advantage in such case: since it does not inject thousands of CSS rules in a page (and frames within that page), this means it makes itself available sooner to handle the task of collapsing the DOM counterpart of blocked network requests. This can be clearly appreciated in the following [test page](http://raymondhill.net/ublock/tiles1.html):
-
-- Chromium + uBlock: minimal flickering (sometimes none)
-- Chromium + ABP: noticeable flickering
-- Firefox + uBlock: no flickering
-- Firefox + ABP: no flickering
-
-Another advantage of uBlock here is that these collapsed-DOM-counterpart-of-blocked-network-requests are cached as temporary specific cosmetic filters internally.