diff --git a/doc/configuration.rst b/doc/configuration.rst
index 50ad1890..e42e32cf 100644
--- a/doc/configuration.rst
+++ b/doc/configuration.rst
@@ -582,15 +582,16 @@ Options
     in your new compose.
 
 **signed_packages_retries** = 0
-    (*int*) -- In automated workflows a compose may start before signed
-    packages are written to disk. In such case it may make sense to wait for
-    the package to appear on storage. This option controls how many times to
-    retry looking for the signed copy.
+    (*int*) -- In automated workflows, you might start a compose before Koji
+    has completely written all signed packages to disk. In this case you may
+    want Pungi to wait for the package to appear in Koji's storage. This
+    option controls how many times Pungi will retry looking for the signed
+    copy.
 
 **signed_packages_wait** = 30
-    (*int*) -- Interval in seconds for how long to wait between attemts to find
-    signed packages. This option only makes sense when
-    ``signed_packages_retries`` is set higher than to 0.
+    (*int*) -- Interval in seconds for how long to wait between attempts to
+    find signed packages. This option only makes sense when
+    ``signed_packages_retries`` is set higher than 0.
 
 
 Example