Performance guidelines for decl. WebRequest API

chrome/common/extensions/docs/templates/intros/declarativeWebRequest.html

 <h2 id="notes">Notes</h2>
 
 <p>
 Use the <code>chrome.declarativeWebRequest</code> module to intercept, block, or
 modify requests in-flight. It is significantly faster than the <a
   href="webRequest.html"><code>chrome.webRequest</code> API</a> because you can
 register rules that are evaluated in the browser rather than the
 JavaScript engine which reduces roundtrip latencies and allows very high
 efficiency.
 </p>
@@ skipping 102 matching lines @@
 Register rules as follows:
 </p>
 <pre>
 chrome.declarativeWebRequest.onRequest.addRules([rule2]);
 </pre>
 
 <p class="note">
 <strong>Note:</strong> You should always register or unregister rules in bulk rather than
 individually because each of these operations recreates internal data
 structures.  This re-creation is computationally expensive but facilitates a
-very fast URL matching algorithm for hundreds of thousands of URLs.
+very fast URL matching algorithm for hundreds of thousands of URLs. The
+<a href="events.html#performance">Performance section</a> of the $ref:[events
+Events] API provides further performance tips.
 </p>
 
 
 <h2 id="evaluation">Evaluation of conditions and actions</h2>
 
 <p>
 The Declarative Web Request API follows the
 <a href="webRequest.html#life_cycle">Life cycle model for web requests</a> of
 the <a href="webRequest.html">Web Request API</a>. This means that conditions
 can only be tested at specific stages of a web request and, likewise, actions
@@ skipping 101 matching lines @@
 chrome.declarativeWebRequest.onRequest.addRules([rule1, rule2]);
 </pre>
 
 <p>
 It is important to recognize that the <code>IgnoreRules</code> action is not
 persisted across <a href="#evaluation">request stages</a>. All conditions of
 all rules are evaluated at each stage of a web request. If an
 <code>IgnoreRules</code> action is executed, it applies only to other actions
 that are executed for the same web request in the same stage.
 </p>