minor #777 Fix/improve code blocks with Symfony's code-block-checker (bocharsky-bw)

This PR was squashed before being merged into the 2.x branch.

Discussion
----------

Fix/improve code blocks with Symfony's code-block-checker

| Q             | A
| ------------- | ---
| Bug fix?      | yes
| New feature?  | yes
| Tickets       | <!-- prefix each issue number with "Fix #", no need to create an issue if none exist, explain below instead -->
| License       | MIT

Fix/improve code blocks with https://github.com/symfony-tools/code-block-checker

Commits
-------

c3baf467 Fix/improve code blocks with Symfony's code-block-checker

Author: fullstackdeveloperwebapp

src/Autocomplete/doc/index.rst

@@ -229,22 +229,27 @@ to the options above, you can also pass:
 
         use Symfony\Component\Security\Core\Security;
 
-        'security' => function(Security $security): bool {
-            return $security->isGranted('ROLE_FOO');
-        }
+        [
+            'security' => function(Security $security): bool {
+                return $security->isGranted('ROLE_FOO');
+            },
+        ];
 
 ``filter_query`` (default: ``null``)
     If you want to completely control the query made for the "search results",
     use this option. This is incompatible with ``searchable_fields``::
 
-        'filter_query' => function(QueryBuilder $qb, string $query, EntityRepository $repository) {
-            if (!$query) {
-                return;
-            }
+        [
+            'filter_query' => function(QueryBuilder $qb, string $query, EntityRepository $repository) {
+                if (!$query) {
+                    return;
+                }
+
+                $qb->andWhere('entity.name LIKE :filter OR entity.description LIKE :filter')
+                    ->setParameter('filter', '%'.$query.'%');
+            },
+        ];
 
-            $qb->andWhere('entity.name LIKE :filter OR entity.description LIKE :filter')
-                ->setParameter('filter', '%'.$query.'%');
-        }
 ``max_results`` (default: 10)
     Allow you to control the max number of results returned by the automatic autocomplete endpoint.
 
@@ -305,7 +310,9 @@ Then specify this new route on the attribute::
     // src/Form/FoodAutocompleteField.php
     #[AsEntityAutocompleteField(route: 'ux_entity_autocomplete_admin')]
     class FoodAutocompleteField
-    // ...
+    {
+        // ...
+    }
 
 Extending Tom Select
 --------------------

src/LiveComponent/doc/index.rst

@@ -448,7 +448,7 @@ By default, the user can't change the *properties* of an object ``LiveProp``
         public Post $post;
 
         #[LiveProp(writable: ['allow_markdown'])]
-        public array $options = ['allow_markdown' => true, 'allow_html' => false]
+        public array $options = ['allow_markdown' => true, 'allow_html' => false];
     }
 
 Now ``post.title``, ``post.content`` or ``options.allow_markdown`` can be used like
@@ -475,11 +475,17 @@ Any other properties on the object (or keys on the array) will be read-only.
 For arrays, you can set ``writable: true`` to allow *any* key in the array to be
 changed, added or removed::
 
-    #[LiveProp(writable: true)]
-    public array $options = ['allow_markdown' => true, 'allow_html' => false];
+    #[AsLiveComponent('edit_post')]
+    class EditPostComponent
+    {
+        // ...
 
-    #[LiveProp(writable: true)]
-    public array $todoItems = ['Train tiger', 'Feed tiger', 'Pet tiger'];
+        #[LiveProp(writable: true)]
+        public array $options = ['allow_markdown' => true, 'allow_html' => false];
+
+        #[LiveProp(writable: true)]
+        public array $todoItems = ['Train tiger', 'Feed tiger', 'Pet tiger'];
+    }
 
 .. note::
 
@@ -495,11 +501,15 @@ Checkboxes, Select Elements Radios & Arrays
 
 Checkboxes can be used to set a boolean or an array of strings::
 
-    #[LiveProp(writable: true)]
-    public bool $agreeToTerms = false;
+    #[AsLiveComponent('edit_post')]
+    class EditPostComponent
+    {
+        #[LiveProp(writable: true)]
+        public bool $agreeToTerms = false;
 
-    #[LiveProp(writable: true)]
-    public array $foods = ['pizza', 'tacos'];
+        #[LiveProp(writable: true)]
+        public array $foods = ['pizza', 'tacos'];
+    }
 
 In the template, setting a ``value`` attribute on the checkbox will set that
 value on checked. If no ``value`` is set, the checkbox will set a boolean value:
@@ -515,11 +525,17 @@ value on checked. If no ``value`` is set, the checkbox will set a boolean value:
 ``select`` and ``radio`` elements are a bit easier: use these to either set a
 single value or an array of values::
 
-    #[LiveProp(writable: true)]
-    public string $meal = 'lunch';
+    #[AsLiveComponent('edit_post')]
+    class EditPostComponent
+    {
+        // ...
+
+        #[LiveProp(writable: true)]
+        public string $meal = 'lunch';
 
-    #[LiveProp(writable: true)]
-    public array $foods = ['pizza', 'tacos'];
+        #[LiveProp(writable: true)]
+        public array $foods = ['pizza', 'tacos'];
+    }
 
 .. code-block:: html+twig
 
@@ -549,8 +565,14 @@ the user to switch the *entity* to another? For example:
 
 To make the ``post`` property itself writable, use ``writable: true``::
 
-    #[LiveProp(writable: true)]
-    public Post $post;
+    use App\Entity\Post;
+
+    #[AsLiveComponent('edit_post')]
+    class EditPostComponent
+    {
+        #[LiveProp(writable: true)]
+        public Post $post;
+    }
 
 .. caution::
 
@@ -561,8 +583,14 @@ To make the ``post`` property itself writable, use ``writable: true``::
 If you want the user to be able to change the ``Post`` *and* certain
 properties, use the special ``LiveProp::IDENTITY`` constant::
 
-    #[LiveProp(writable: [LiveProp::IDENTITY, 'title', 'content'])]
-    public Post $post;
+    use App\Entity\Post;
+
+    #[AsLiveComponent('edit_post')]
+    class EditPostComponent
+    {
+        #[LiveProp(writable: [LiveProp::IDENTITY, 'title', 'content'])]
+        public Post $post;
+    }
 
 Note that being able to change the "identity" of an object is something
 that works only for objects that are dehydrated to a scalar value (like
@@ -578,9 +606,15 @@ when they are sent back to the backend.
 If needed, you can control the normalization or denormalization context using
 the ``Context`` attribute from Symfony's serializer::
 
-    #[LiveProp]
-    #[Context(groups: ['my_group'])]
-    public Post $post;
+    use App\Entity\Post;
+
+    #[AsLiveComponent('edit_post')]
+    class EditPostComponent
+    {
+        #[LiveProp]
+        #[Context(groups: ['my_group'])]
+        public Post $post;
+    }
 
 .. note::
 
@@ -1641,17 +1675,19 @@ Here are some examples of these techniques.
 If you only want to customize some attributes, the simplest to use the options in the form type::
 
     // ...
-    ->add('comments', LiveCollectionType::class, [
-        'entry_type' => CommentFormType::class,
-        'label' => false,
-        'button_delete_options' => [
-            'label' => 'X',
-            'attr' => [
-                'class' => 'btn btn-outline-danger',
-            ],
-        ]
-    ])
-    // ...
+    $builder
+        // ...
+        ->add('comments', LiveCollectionType::class, [
+            'entry_type' => CommentFormType::class,
+            'label' => false,
+            'button_delete_options' => [
+                'label' => 'X',
+                'attr' => [
+                    'class' => 'btn btn-outline-danger',
+                ],
+            ]
+        ])
+    ;
 
 Inline rendering:
 
@@ -2011,7 +2047,7 @@ There are three ways to emit an event:
 
     class MyComponent
     {
-        use ComponentEmitsTrait
+        use ComponentEmitsTrait;
 
         #[LiveAction]
         public function saveProduct()

src/Notify/doc/index.rst

@@ -34,8 +34,7 @@ properly configured notifier transport:
 
 .. code-block:: yaml
 
-    // config/packages/notifier.yaml
-
+    # config/packages/notifier.yaml
     framework:
         notifier:
             chatter_transports:

src/Turbo/doc/index.rst

@@ -589,7 +589,7 @@ updates and deletions of entities::
     #[Broadcast] // 🔥 The magic happens here
     class Book
     {
-        #[ORM\Column, ORM\Id, ORM\GeneratedValue(strategy="AUTO")]
+        #[ORM\Column, ORM\Id, ORM\GeneratedValue(strategy: "AUTO")]
         public ?int $id = null;
 
         #[ORM\Column]

src/TwigComponent/doc/index.rst

@@ -308,6 +308,8 @@ i.e. because they don't correspond to any property. You can handle and remove th
 here. For example, imagine an extra ``autoChooseType`` prop were passed when
 creating the ``alert`` component::
 
+.. code-block:: twig
+
     {{ component('alert', {
         message: 'Danger Will Robinson!',
         autoChooseType: true,