diff --git a/docs/config.md b/docs/config.md
index 306d7e3f4..788a6b079 100644
--- a/docs/config.md
+++ b/docs/config.md
@@ -12,7 +12,7 @@ A minimal `Caddyfile` to serve a PHP application is shown below:
 # The hostname to respond to
 localhost
 
-# Optionaly, the directory to serve files from, otherwise defaults to the current directory
+# Optionally, the directory to serve files from, otherwise defaults to the current directory
 #root public/
 php_server
 ```
diff --git a/docs/worker.md b/docs/worker.md
index e055436d3..32c54b2bf 100644
--- a/docs/worker.md
+++ b/docs/worker.md
@@ -163,6 +163,13 @@ frankenphp {
 }
 ```
 
+### Number of threads
+
+When the worker mode is enabled, an additional thread is required to handle the incoming requests,
+so the default `num_threads` value is `1 + 2x(number of available CPUs)`.
+
+Thus, in that mode if `num_threads` and `num` are explicitly set, `num_threads` must be strictly greater then `num`.
+
 ## Superglobals Behavior
 
 [PHP superglobals](https://www.php.net/manual/en/language.variables.superglobals.php) (`$_SERVER`, `$_ENV`, `$_GET`...)