Apply comments after the review

Author: bocharsky-bw

src/StimulusBundle/doc/index.rst

@@ -57,7 +57,15 @@ directory. In fact, you should have an example controller there already: ``hello
         }
     }
 
-Use the Twig functions from this bundle to activate your controllers:
+Then, activate the controller in your HTML:
+
+.. code-block:: html+twig
+
+    <div data-controller="hello">
+       ...
+    </div>
+
+Optionally, this bundle has a Twig function to render the attribute:
 
 .. code-block:: html+twig
 
@@ -166,10 +174,11 @@ actions & targets in your templates.
 
 .. note::
 
-    Though this bundle provides these helpful functions/filters, it's recommended to
-    use raw data attributes instead. If you use PhpStorm - you may want to install
-    [Stimulus plugin](https://plugins.jetbrains.com/plugin/18940-stimulus) that will
-    bring you nice autocompletion for them.
+    Though this bundle provides these helpful Twig functions/filters, it's
+    recommended to use raw data attributes instead, as they're simple enough.
+    If you use PhpStorm IDE - you may want to install
+    [Stimulus plugin](https://plugins.jetbrains.com/plugin/18940-stimulus)
+    to get nice auto-completion for the attributes.
 
 stimulus_controller
 ~~~~~~~~~~~~~~~~~~~