From 8441ec3eafc794bbac30959469e9513f3e11bc55 Mon Sep 17 00:00:00 2001
From: seb-jean <sebastien.jean76@gmail.com>
Date: Fri, 3 Jan 2025 19:40:42 +0100
Subject: [PATCH 1/3] Document <twig:Turbo:Stream:*>

---
 src/Turbo/doc/index.rst | 186 ++++++++++++++++++++++++++++++++++++++--
 1 file changed, 180 insertions(+), 6 deletions(-)

diff --git a/src/Turbo/doc/index.rst b/src/Turbo/doc/index.rst
index 4618bd701c2..ab1619ccc6b 100644
--- a/src/Turbo/doc/index.rst
+++ b/src/Turbo/doc/index.rst
@@ -394,19 +394,193 @@ Let's discover how to use Turbo Streams to enhance your `Symfony forms`_::
 
     {# bottom of new.html.twig #}
     {% block success_stream %}
-    <turbo-stream action="replace" targets="#my_div_id">
-        <template>
-            The element having the id "my_div_id" will be replaced by this block, without a full page reload!
+        <turbo-stream action="replace" targets="#my_div_id">
+            <template>
+                The element having the id "my_div_id" will be replaced by this block, without a full page reload!
 
-            <div>The task "{{ task }}" has been created!</div>
-        </template>
-    </turbo-stream>
+                <div>The task "{{ task }}" has been created!</div>
+            </template>
+        </turbo-stream>
     {% endblock %}
 
 Supported actions are ``append``, ``prepend``, ``replace``, ``update``,
 ``remove``, ``before``, ``after`` and ``refresh``.
 `Read the Turbo Streams documentation for more details`_.
 
+Stream Messages and Actions
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+To render a ``<turbo-stream>`` element, we recommend using the ``<twig:Turbo:Stream:*>`` Twig Component to avoid typos.
+
+Append
+""""""
+
+.. code-block:: html+twig
+
+    <twig:Turbo:Stream:Append target="#dom_id">
+        Content to append to container designated with the dom_id.
+    </twig:Turbo:Stream:Append>
+
+    {# renders as: #}
+    <turbo-stream action="append" targets="#dom_id">
+        <template>
+            Content to append to container designated with the dom_id.
+        </template>
+    </turbo-stream>
+
+For more info, see: `Turbo Streams - Append <https://turbo.hotwired.dev/reference/streams#append>`_.
+
+Prepend
+"""""""
+
+.. code-block:: html+twig
+
+    <twig:Turbo:Stream:Prepend target="#dom_id">
+        Content to prepend to container designated with the dom_id.
+    </twig:Turbo:Stream:Prepend>
+
+    {# renders as: #}
+    <turbo-stream action="prepend" targets="#dom_id">
+        <template>
+            Content to prepend to container designated with the dom_id.
+        </template>
+    </turbo-stream>
+
+For more info, see: `Turbo Streams - Prepend <https://turbo.hotwired.dev/reference/streams#prepend>`_.
+
+Replace
+"""""""
+
+.. code-block:: html+twig
+
+    <twig:Turbo:Stream:Replace target="#dom_id">
+        Content to replace the element designated with the dom_id.
+    </twig:Turbo:Stream:Replace>
+
+    {# renders as: #}
+    <turbo-stream action="replace" targets="#dom_id">
+        <template>
+            Content to replace the element designated with the dom_id.
+        </template>
+    </turbo-stream>
+
+.. code-block:: html+twig
+
+    {# with morphing #}
+    <twig:Turbo:Stream:Replace target="#dom_id" morph>
+        Content to replace the element.
+    </twig:Turbo:Stream:Replace>
+
+    {# renders as: #}
+    <turbo-stream action="replace" targets="#dom_id" method="morph">
+        <template>
+            Content to replace the element.
+        </template>
+    </turbo-stream>
+
+For more info, see: `Turbo Streams - Replace <https://turbo.hotwired.dev/reference/streams#replace>`_.
+
+Update
+""""""
+
+.. code-block:: html+twig
+
+    <twig:Turbo:Stream:Update target="#dom_id">
+        Content to update to container designated with the dom_id.
+    </twig:Turbo:Stream:Update>
+
+    {# renders as: #}
+    <turbo-stream action="update" targets="#dom_id">
+        <template>
+            Content to update to container designated with the dom_id.
+        </template>
+    </turbo-stream>
+
+.. code-block:: html+twig
+
+    {# with morphing #}
+    <twig:Turbo:Stream:Update target="#dom_id" morph>
+        Content to replace the element.
+    </twig:Turbo:Stream:Update>
+
+    {# renders as: #}
+    <turbo-stream action="update" targets="#dom_id" method="morph">
+        <template>
+            Content to replace the element.
+        </template>
+    </turbo-stream>
+
+For more info, see: `Turbo Streams - Update <https://turbo.hotwired.dev/reference/streams#update>`_.
+
+Remove
+""""""
+
+.. code-block:: html+twig
+
+    <twig:Turbo:Stream:Remove target="#dom_id" />
+
+    {# renders as: #}
+    <turbo-stream action="remove" targets="#dom_id"></turbo-stream>
+
+For more info, see: `Turbo Streams - Remove <https://turbo.hotwired.dev/reference/streams#remove>`_.
+
+Before
+""""""
+
+.. code-block:: html+twig
+
+    <twig:Turbo:Stream:Before target="#dom_id">
+        Content to place before the element designated with the dom_id.
+    </twig:Turbo:Stream:Before>
+
+    {# renders as: #}
+    <turbo-stream action="before" targets="#dom_id">
+        <template>
+            Content to place before the element designated with the dom_id.
+        </template>
+    </turbo-stream>
+
+For more info, see: `Turbo Streams - Before <https://turbo.hotwired.dev/reference/streams#before>`_.
+
+After
+"""""
+
+.. code-block:: html+twig
+
+    <twig:Turbo:Stream:Refresh target="#dom_id">
+        Content to place after the element designated with the dom_id.
+    </twig:Turbo:Stream:After>
+
+    {# renders as: #}
+    <turbo-stream action="after" targets="#dom_id">
+        <template>
+            Content to place after the element designated with the dom_id.
+        </template>
+    </turbo-stream>
+
+For more info, see: `Turbo Streams - After <https://turbo.hotwired.dev/reference/streams#after>`_.
+
+Refresh
+"""""""
+
+.. code-block:: html+twig
+
+    {# without [request-id] #}
+    <twig:Turbo:Stream:Refresh />
+
+    {# renders as: #}
+    <turbo-stream action="refresh"></turbo-stream>
+
+.. code-block:: html+twig
+
+    {# debounced with [request-id] #}
+    <twig:Turbo:Stream:Refresh requestId="abcd-1234" />
+
+    {# renders as: #}
+    <turbo-stream action="refresh" request-id="abcd-1234"></turbo-stream>
+
+For more info, see: `Turbo Streams - Refresh <https://turbo.hotwired.dev/reference/streams#refresh>`_.
+
 Resetting the Form
 ~~~~~~~~~~~~~~~~~~
 

From 79a01807bc46e9bdf81339f63e4080f11e03eae7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Simon=20Andr=C3=A9?= <smn.andre@gmail.com>
Date: Sun, 9 Feb 2025 03:40:35 +0100
Subject: [PATCH 2/3] Remove too many links

---
 src/Turbo/doc/index.rst | 16 ----------------
 1 file changed, 16 deletions(-)

diff --git a/src/Turbo/doc/index.rst b/src/Turbo/doc/index.rst
index ab1619ccc6b..a3d46f55fc5 100644
--- a/src/Turbo/doc/index.rst
+++ b/src/Turbo/doc/index.rst
@@ -428,8 +428,6 @@ Append
         </template>
     </turbo-stream>
 
-For more info, see: `Turbo Streams - Append <https://turbo.hotwired.dev/reference/streams#append>`_.
-
 Prepend
 """""""
 
@@ -446,8 +444,6 @@ Prepend
         </template>
     </turbo-stream>
 
-For more info, see: `Turbo Streams - Prepend <https://turbo.hotwired.dev/reference/streams#prepend>`_.
-
 Replace
 """""""
 
@@ -478,8 +474,6 @@ Replace
         </template>
     </turbo-stream>
 
-For more info, see: `Turbo Streams - Replace <https://turbo.hotwired.dev/reference/streams#replace>`_.
-
 Update
 """"""
 
@@ -510,8 +504,6 @@ Update
         </template>
     </turbo-stream>
 
-For more info, see: `Turbo Streams - Update <https://turbo.hotwired.dev/reference/streams#update>`_.
-
 Remove
 """"""
 
@@ -522,8 +514,6 @@ Remove
     {# renders as: #}
     <turbo-stream action="remove" targets="#dom_id"></turbo-stream>
 
-For more info, see: `Turbo Streams - Remove <https://turbo.hotwired.dev/reference/streams#remove>`_.
-
 Before
 """"""
 
@@ -540,8 +530,6 @@ Before
         </template>
     </turbo-stream>
 
-For more info, see: `Turbo Streams - Before <https://turbo.hotwired.dev/reference/streams#before>`_.
-
 After
 """""
 
@@ -558,8 +546,6 @@ After
         </template>
     </turbo-stream>
 
-For more info, see: `Turbo Streams - After <https://turbo.hotwired.dev/reference/streams#after>`_.
-
 Refresh
 """""""
 
@@ -579,8 +565,6 @@ Refresh
     {# renders as: #}
     <turbo-stream action="refresh" request-id="abcd-1234"></turbo-stream>
 
-For more info, see: `Turbo Streams - Refresh <https://turbo.hotwired.dev/reference/streams#refresh>`_.
-
 Resetting the Form
 ~~~~~~~~~~~~~~~~~~
 

From f572ab5e78afd7183910d232243b4cb146c3d64e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Simon=20Andr=C3=A9?= <smn.andre@gmail.com>
Date: Sat, 22 Feb 2025 01:55:32 +0100
Subject: [PATCH 3/3] Update src/Turbo/doc/index.rst

---
 src/Turbo/doc/index.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Turbo/doc/index.rst b/src/Turbo/doc/index.rst
index a3d46f55fc5..4f71c9119a9 100644
--- a/src/Turbo/doc/index.rst
+++ b/src/Turbo/doc/index.rst
@@ -410,7 +410,7 @@ Supported actions are ``append``, ``prepend``, ``replace``, ``update``,
 Stream Messages and Actions
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-To render a ``<turbo-stream>`` element, we recommend using the ``<twig:Turbo:Stream:*>`` Twig Component to avoid typos.
+To render a ``<turbo-stream>`` element, this bundle provides a set of ``<twig:Turbo:Stream:*>`` Twig Components. These components make it easy to inject content directly into the ``<template>`` tag, pass attributes, and set the desired morphing mode with a clear and consistent syntax.
 
 Append
 """"""