Add a note about using raw data attributes as a prefered way

Now with the Stimulus plugin autocomplete in PhpStorm it's better to use raw data attributes instead of built-in functions/filters. Normal Stimulus code is more readable and cleaner IMO.

Author: bocharsky-bw

src/StimulusBundle/doc/index.rst

@@ -65,6 +65,11 @@ Use the Twig functions from this bundle to activate your controllers:
         ...
     </div>
 
+    <!-- would render -->
+    <div data-controller="hello">
+       ...
+    </div>
+
 That's it! Whenever this element appears on the page, the ``hello`` controller
 will activate.
 
@@ -159,6 +164,13 @@ Stimulus Twig Helpers
 This bundle adds 3 Twig functions/filters to help add Stimulus controllers,
 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.
+
 stimulus_controller
 ~~~~~~~~~~~~~~~~~~~
 
@@ -243,6 +255,11 @@ there's also a ``stimulus_controller`` filter:
         Hello
     </div>
 
+    <!-- would render -->
+    <div data-controller="chart other-controller" data-chart-name-value="Likes">
+        Hello
+    </div>
+
 You can also retrieve the generated attributes as an array, which can be helpful e.g. for forms:
 
 .. code-block:: twig