Reword

Author: javiereguiluz

components/console/helpers/progressbar.rst

@@ -50,10 +50,15 @@ you can also set the current progress by calling the
 
     If your platform doesn't support ANSI codes, updates to the progress
     bar are added as new lines. To prevent the output from being flooded,
-    you may adjust the update interval via these methods
-    :method:`Symfony\\Component\\Console\\Helper\\ProgressBar::preventRedrawFasterThan` - write after each x seconds
-    :method:`Symfony\\Component\\Console\\Helper\\ProgressBar::setRedrawFrequency` - write each x iteration
-    By default, redraw frequency is **100ms** or each **10%** of your ``max``.
+    use the method :method:`Symfony\\Component\\Console\\Helper\\ProgressBar::preventRedrawFasterThan`
+    (it writes to the output after every N seconds) and the method
+    :method:`Symfony\\Component\\Console\\Helper\\ProgressBar::setRedrawFrequency`
+    (it writes to the output every N iterations). By default, redraw frequency is
+    **100ms** or **10%** of your ``max``.
+
+    .. versionadded::
+
+        The ``preventRedrawFasterThan()`` method was introduced in Symfony 4.4.
 
 If you don't know the exact number of steps in advance, set it to a reasonable
 value and then call the ``setMaxSteps()`` method to update it as needed::
@@ -289,22 +294,19 @@ to display it can be customized::
 
 .. caution::
 
-    By default, for performance reasons Symfony redraws screen every 100ms.
-    In special cases, this can be too often and might hurt performance.
-    In other cases, this can be opposite and it hurts UX.
-    In either of these cases, consider tweaking redraw frequency by either of these methods:
+    For performance reasons, Symfony redraws screen every 100ms. If this is too
+    fast or to slow for your application, use these methods:
     :method:`Symfony\\Component\\Console\\Helper\\ProgressBar::preventRedrawFasterThan`
     :method:`Symfony\\Component\\Console\\Helper\\ProgressBar::setRedrawFrequency`
-    :method:`Symfony\\Component\\Console\\Helper\\ProgressBar::forceRedrawSlowerThan`
-    so it updates on only some iterations::
+    :method:`Symfony\\Component\\Console\\Helper\\ProgressBar::forceRedrawSlowerThan`::
 
         $progressBar = new ProgressBar($output, 50000);
         $progressBar->start();
 
-        // redraw every 100 iterations or every 200ms (in case iterations go too slow)
-        $progressBar->setRedrawFrequency(200);
+        // this redraws the screen every 100 iterations, but sets additional limits:
+        // don't redraw slower than 100ms (0.1) or faster than 200ms (0.2)
+        $progressBar->setRedrawFrequency(100);
         $progressBar->forceRedrawSlowerThan(0.2);
-        // but don't redraw sooner than every 100ms (in case iterations go too fast)
         $progressBar->preventRedrawFasterThan(0.1);
 
         $i = 0;
@@ -314,6 +316,11 @@ to display it can be customized::
             $progressBar->advance();
         }
 
+    .. versionadded::
+
+        The ``forceRedrawSlowerThan`` and ``preventRedrawFasterThan()`` methods
+        were introduced in Symfony 4.4.
+
 Custom Placeholders
 ~~~~~~~~~~~~~~~~~~~