Reword

Author: javiereguiluz

frontend/encore/vuejs.rst

@@ -153,23 +153,21 @@ you can import them with ``require()`` function:
         }
     }
 
-Embeded with Twig
------------------
+Using Vue inside Twig templates
+-------------------------------
 
-You can of course, inside a Twig template rendered from a controller,
-instantiate a Vue.js app as any other JavaScript code.
+Twig templates can instantiate a Vue.js app in the same way as any other
+JavaScript code. However, given that both Twig and Vue.js use the same delimiters
+for variables, you should configure the ``delimiters`` Vue.js option to change
+the default variable delimiters.
 
-.. tip::
+If you set for example ``delimiters: ['${', '}$']``, then you can use the
+following in your Twig templates:
 
-    You may in this case leverage the delimiters options
- to not overlap with Twig ones.
-    For example, using `delimiters: ['${', '}$']` inside the Vue.js instance.
- 
  .. code-block:: twig
- 
-    {{ twig_var }} renders a Twig variable
-    ${ vuejs_var }$ renders a Vue.js variable
 
+    {{ twig_variable }}   {# renders a Twig variable #}
+    ${ vuejs_variable }$  {# renders a Vue.js variable #}
 
 .. _`Vue.js`: https://vuejs.org/
 .. _`vue-loader options`: https://vue-loader.vuejs.org/options.html