# HG changeset patch
# User Ruslan Ermilov <ru@nginx.com>
# Date 1323191959 0
# Node ID c4b33b07dcfe777722b9785d42be17291b1f43c5
# Parent  46ef98b7513fc9ab23953b11c780306dbac8881f
Added some basic hints on how to tune "worker_processes".

diff --git a/xml/en/docs/ngx_core_module.xml b/xml/en/docs/ngx_core_module.xml
--- a/xml/en/docs/ngx_core_module.xml
+++ b/xml/en/docs/ngx_core_module.xml
@@ -291,6 +291,14 @@ worker_priority -10;
 Defines the number of worker processes.
 </para>
 
+<para>
+The optimal value depends on many factors including (but not
+limited to) the number of CPU cores, the number of hard disk
+drives that store data, and load pattern.
+When in doubt, setting it to the number of available CPU cores
+would be a good start.
+</para>
+
 </directive>