Update README

Author: pbories

README.md

@@ -344,4 +344,36 @@ You can also retrieve the generated attributes as an array, which can be helpful
 {{ form_row(form.password, { attr: stimulus_target('hello-controller', 'a-target').toArray() }) }}
 ```
 
+### stimulus_outlet
+
+The `stimulus_outlet()` Twig function can be used to render [Stimulus Outlets](https://stimulus.hotwired.dev/reference/outlets).
+
+For example:
+
+```twig
+<div {{ stimulus_outlet('controller', 'foo', '.selector') }}>Hello</div>
+
+<!-- would render -->
+<div data-controller-foo-outlet=".selector">Hello</div>
+```
+
+If you have multiple outlets on the same element, you can chain them as there's also a `stimulus_outlet` filter:
+
+```twig
+<div {{ stimulus_outlet('controller', 'foo', '.selector')|stimulus_outlet('other-controller', 'bar', '#another-selector') }}>
+    Hello
+</div>
+
+<!-- would render -->
+<div data-controller-foo-outlet=".selector" data-other-controller-bar-outlet="#another-selector">
+    Hello
+</div>
+```
+
+You can also retrieve the generated attributes as an array, which can be helpful e.g. for forms:
+
+```twig
+{{ form_row(form.password, { attr: stimulus_outlet('hello-controller', 'foo', '.selector').toArray() }) }}
+```
+
 Ok, have fun!