diff --git a/lib/puma/dsl.rb b/lib/puma/dsl.rb
index 17533dbdfa..ce73f16d73 100644
--- a/lib/puma/dsl.rb
+++ b/lib/puma/dsl.rb
@@ -405,7 +405,10 @@ def log_formatter(&block)
     # Configure +min+ to be the minimum number of threads to use to answer
     # requests and +max+ the maximum.
     #
-    # The default is "0, 5" in MRI or "0, 16" for other interpreters.
+    # The default is the environment variables +PUMA_MIN_THREADS+ / +PUMA_MAX_THREADS+
+    # (or +MIN_THREADS+ / +MAX_THREADS+ if the +PUMA_+ variables aren't set).
+    #
+    # If these environment variables aren't set, the default is "0, 5" in MRI or "0, 16" for other interpreters.
     #
     # @example
     #   threads 0, 16
@@ -470,7 +473,8 @@ def state_permission(permission)
     # How many worker processes to run.  Typically this is set to
     # the number of available cores.
     #
-    # The default is 0.
+    # The default is the value of the environment variable +WEB_CONCURRENCY+ if
+    # set, otherwise 0.
     #
     # @note Cluster mode only.
     # @see Puma::Cluster