updating documentation

Author: weaverryan

README.md

@@ -105,21 +105,53 @@ If you want more control, you can use the `encore_entry_js_files()` and
 `encore_entry_css_files()` methods to get the list of files needed, then
 loop and create the `script` and `link` tags manually.
 
-## Rendering Multiple Times in a Request (e.g. to Generate a PDF)
+## Rendering Multiple Templates (e.g. Emails or PDFs)
 
 When you render your script or link tags, the bundle is smart enough
 not to repeat the same JavaScript or CSS file within the same request.
 This prevents you from having duplicate `<link>` or `<script>` tags
-if you render multiple entries that both rely on the same file.
+if you render multiple entries that rely on the same file.
 
 In some cases, however, you may want to render the script & link
-tags for the same entry multiple times in a request. For example,
-if you render multiple Twig templates to create multiple PDF files
-during a single request.
+tags for the same entry multiple times in a request - for example
+when rendering Twig templates for a PDF or for an email.
 
-In that case, before each render, you'll need to "reset" the internal
-cache so that the bundle re-renders CSS or JS files that it previously
-rendered. For example, in a controller:
+The easiest solution is to *disable* the "file tracking" on those
+templates:
+
+```twig
+{# some template that renders a PDF or an email #}
+
+{% do encore_disable_file_tracking() %}
+    {{ encore_entry_link_tags('entry1') }}
+    {{ encore_entry_script_tags('entry1') }}
+{% do encore_enable_file_tracking() %}
+```
+
+With this, *all* JS and CSS files for `entry1` will be rendered and
+this won't affect any other Twig templates rendered in the request.
+
+You can also use this along with `inline_css` and `encore_entry_css_source()`
+to automatically convert the CSS to inline styles so that your emails
+or PDF doesn't require any external CSS files:
+
+```twig
+{% do encore_disable_file_tracking() %}
+{% apply inline_css(encore_entry_css_source('my_entry')) %}
+    <div>
+        Hi! The CSS from my_entry will be converted into
+        inline styles on any HTML elements inside.
+    </div>
+{% endapply %}
+{% do encore_enable_file_tracking() %}
+```
+
+## Resetting the Entrypoint
+
+If using `encore_disable_file_tracking()` won't work for you for some
+reason, you can also "reset" EncoreBundle's internal cache so that the
+bundle re-renders CSS or JS files that it previously rendered. For
+example, in a controller:
 
 ```php
 // src/Controller/SomeController.php