Minor tweaks

Author: javiereguiluz

components/var_exporter.rst

@@ -177,53 +177,53 @@ populated by using the special ``"\0"`` property name to define their internal v
         "\0" => [$inputArray],
     ]);
 
-Creating Lazy Objects on PHP ≥ 8.4
-----------------------------------
+Creating Lazy Objects
+---------------------
 
-Since version 8.4, PHP provides support for lazy objects via the reflection API.
-This native API works with concrete classes. It doesn't with abstracts nor with
-internal ones.
+Lazy objects are objects instantiated empty and populated on demand. This is
+particularly useful when, for example, a class has properties that require
+heavy computation to determine their values. In such cases, you may want to
+trigger the computation only when the property is actually accessed. This way,
+the expensive processing is avoided entirely if the property is never used.
 
-This components provides helpers to generate lazy objects using the decorator
-pattern, which works with abstract or internal classes and with interfaces::
+Since version 8.4, PHP provides support for lazy objects via the reflection API.
+This native API works with concrete classes, but not with abstract or internal ones.
+This component provides helpers to generate lazy objects using the decorator
+pattern, which also works with abstract classes, internal classes, and interfaces::
 
     $proxyCode = ProxyHelper::generateLazyProxy(new \ReflectionClass(SomeInterface::class));
-    // $proxyCode should be dumped into a file in production envs
+    // $proxyCode should be dumped into a file in production environments
     eval('class ProxyDecorator'.$proxyCode);
 
     $proxy = ProxyDecorator::createLazyProxy(initializer: function (): SomeInterface {
-        // [...] Use whatever heavy logic you need here
+        // use whatever heavy logic you need here
         // to compute the $dependencies of the proxied class
         $instance = new SomeHeavyClass(...$dependencies);
-        // [...] Call setters, etc. if needed
+        // call setters, etc. if needed
 
         return $instance;
     });
 
 Use this mechanism only when native lazy objects cannot be leveraged
-(or you'll get a deprecation notice.)
+(otherwise you'll get a deprecation notice).
 
-Creating Lazy Objects on PHP < 8.3
-----------------------------------
+Legacy Creation of Lazy Objects
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Lazy-objects are objects instantiated empty and populated on-demand. This is
-particularly useful when you have for example properties in your classes that
-requires some heavy computation to determine their value. In this case, you
-may want to trigger the property's value processing only when you actually need
-its value. Thanks to this, the heavy computation won't be done if you never use
-this property. The VarExporter component is bundled with two traits helping
-you implement such mechanism easily in your classes.
+When using a PHP version earlier than 8.4, native lazy objects are not available.
+In these cases, the VarExporter component provides two traits that help you
+implement lazy-loading mechanisms in your classes.
 
 .. _var-exporter_ghost-objects:
 
 LazyGhostTrait
-~~~~~~~~~~~~~~
+..............
 
 .. deprecated:: 7.3
 
-   ``LazyGhostTrait`` is deprecated since Symfony 7.3; use PHP 8.4's native lazy
-   objects instead (note that using the trait with PHP < 8.4 triggers no deprecation
-   to help with the transition.)
+    ``LazyGhostTrait`` is deprecated since Symfony 7.3. Use PHP 8.4's native lazy
+    objects instead. Note that using the trait with PHP versions earlier than 8.4
+    does not trigger a deprecation, to ease the transition.
 
 Ghost objects are empty objects, which see their properties populated the first
 time any method is called. Thanks to :class:`Symfony\\Component\\VarExporter\\LazyGhostTrait`,
@@ -303,13 +303,13 @@ of :ref:`Virtual Proxies <var-exporter_virtual-proxies>`.
 .. _var-exporter_virtual-proxies:
 
 LazyProxyTrait
-~~~~~~~~~~~~~~
+..............
 
 .. deprecated:: 7.3
 
-   ``LazyProxyTrait`` is deprecated since Symfony 7.3; use PHP 8.4's native lazy
-   objects instead (note that using the trait with PHP < 8.4 triggers no deprecation
-   to help with the transition.)
+    ``LazyProxyTrait`` is deprecated since Symfony 7.3. Use PHP 8.4's native lazy
+    objects instead. Note that using the trait with PHP versions earlier than 8.4
+    does not trigger a deprecation, to ease the transition.
 
 The purpose of virtual proxies in the same one as
 :ref:`ghost objects <var-exporter_ghost-objects>`, but their internal behavior is