Vale remarks

Author: mnocon

docs/infrastructure_and_maintenance/cache/persistence_cache.md

@@ -281,15 +281,15 @@ For more info on usage, see [Symfony Cache's documentation]([[= symfony_doc =]]/
 !!! caution "Always clear the persistence with `cache:pool:clear` command"
 
     Running `php bin/console cache:clear` doesn't clear the persistence cache, even when you use a filesystem-based cache pool.
-    
+
     You must always clear the persistence cache by running:
 
     ```bash
-    php bin/console cache:pool:clear [cache-pool]
+    php bin/console cache:pool:clear <cache-pool>
     ```
 
-    The default cache pool is named `cache.tagaware.filesystem`. 
-    The default cache pool when running Redis or Valkey is named `cache.redis`. 
+    The default cache pool is named `cache.tagaware.filesystem`.
+    The default cache pool when running Redis or Valkey is named `cache.redis`.
     If you have customized the persistence cache configuration, the name of your cache pool might be different.
 
 Persistence cache prefixes it's cache using "ibx-". Clearing persistence cache can thus be done in the following ways:

docs/snippets/page_block_cache_clear.md

@@ -2,7 +2,7 @@
 
     Persistence cache must be cleared after any modifications have been made to the block config in Page Builder, such as adding, removing or altering the page blocks, block attributes, validators or views configuration.
 
-    To clear the persistence cache, run `php bin/console cache:pool:clear [cache-pool]` command.
+    To clear the persistence cache, run `php bin/console cache:pool:clear <cache-pool>` command.
     The default cache pool is named `cache.tagaware.filesystem`.
     The default cache pool when running Redis or Valkey is named `cache.redis`.
     If you have customized the [persistence cache configuration](https://doc.ibexa.co/en/latest/infrastructure_and_maintenance/cache/persistence_cache/#what-is-cached), the name of your cache pool might be different.

docs/update_and_migration/from_5.0/update_from_5.0.md

@@ -376,18 +376,18 @@ Update Symfony constraints in `composer.json` before updating the packages.
             To clear the persistence cache, for example after adding a [custom Page Builder block](create_custom_page_block.md), you must always run:
 
             ```bash
-            php bin/console cache:pool:clear [cache-pool]
+            php bin/console cache:pool:clear <cache-pool>
             ```
 
-            The default cache pool is named `cache.tagaware.filesystem`. 
-            The default cache pool when running Redis or Valkey is named `cache.redis`. 
+            The default cache pool is named `cache.tagaware.filesystem`.
+            The default cache pool when running Redis or Valkey is named `cache.redis`.
             If you have customized the persistence cache configuration, the name of your cache pool might be different.
 
             For more information about persistence cache, see [Persistence cache](persistence_cache.md).
 
     - Array-based PHP configuration format
 
-        As part of the [array-based PHP configuration format](https://symfony.com/blog/new-in-symfony-7-4-better-php-configuration), a `config/reference.php` file will be created.
+        As part of the new [array-based PHP configuration format](https://symfony.com/blog/new-in-symfony-7-4-better-php-configuration), Symfony creates the `config/reference.php` file.
         You should commit this file to the repository.
 
 4. Update Ibexa packages by running: