Minor tweaks

javiereguiluz · javiereguiluz · commit d810f6caabcc · 2024-09-30T10:09:10.000+02:00
diff --git a/configuration.rst b/configuration.rst
@@ -385,22 +385,17 @@ a new ``locale`` parameter is added to the ``config/services.yaml`` file).
 Configuration parameters are usually validation-free, but you can ensure that
 essential parameters for your application's functionality are not empty::
 
-    // ContainerBuilder
-    $container->parameterCannotBeEmpty('app.private_key', 'Did you forget to configure a non-empty value for "app.private_key" parameter?');
+    /** @var ContainerBuilder $container */
+    $container->parameterCannotBeEmpty('app.private_key', 'Did you forget to set a value for the "app.private_key" parameter?');
 
 If a non-empty parameter is ``null``, an empty string ``''``, or an empty array ``[]``,
-Symfony will throw an exception with the custom error message when attempting to
-retrieve the value of this parameter.
+Symfony will throw an exception. This validation is **not** made at compile time
+but when attempting to retrieve the value of the parameter.
 
 .. versionadded:: 7.2
 
     Validating non-empty parameters was introduced in Symfony 7.2.
 
-.. note::
-
-    Please note that this validation will *only* occur if a non-empty parameter value
-    is retrieved; otherwise, no exception will be thrown.
-
 .. seealso::
 
     Later in this article you can read how to
