[DOCS] queue_job: make clear the relationship with workers amount

Adding docs for #431 (comment), which could be surprising and, if not taken into account, could easily block any DB using queue_job.

@moduon MT-6106

queue_job/README.rst

@@ -100,6 +100,9 @@ Configuration
   * Start Odoo with ``--load=web,queue_job``
     and ``--workers`` greater than 1. [1]_
 
+* Keep in mind that the number of workers should be greater than the number of
+  channels. ``queue_job`` will reuse normal Odoo workers to process jobs. It
+  will not spawn its own workers.
 
 * Using the Odoo configuration file:
 
@@ -114,6 +117,8 @@ Configuration
   [queue_job]
   channels = root:2
 
+* Environment variables have priority over the configuration file.
+
 * Confirm the runner is starting correctly by checking the odoo log file:
 
 .. code-block::

queue_job/readme/CONFIGURE.rst

@@ -10,6 +10,9 @@
   * Start Odoo with ``--load=web,queue_job``
     and ``--workers`` greater than 1. [1]_
 
+* Keep in mind that the number of workers should be greater than the number of
+  channels. ``queue_job`` will reuse normal Odoo workers to process jobs. It
+  will not spawn its own workers.
 
 * Using the Odoo configuration file:
 
@@ -24,6 +27,8 @@
   [queue_job]
   channels = root:2
 
+* Environment variables have priority over the configuration file.
+
 * Confirm the runner is starting correctly by checking the odoo log file:
 
 .. code-block::

queue_job/static/description/index.html

@@ -8,10 +8,11 @@
 
 /*
 :Author: David Goodger (goodger@python.org)
-:Id: $Id: html4css1.css 8954 2022-01-20 10:10:25Z milde $
+:Id: $Id: html4css1.css 9511 2024-01-13 09:50:07Z milde $
 :Copyright: This stylesheet has been placed in the public domain.
 
 Default cascading style sheet for the HTML output of Docutils.
+Despite the name, some widely supported CSS2 features are used.
 
 See https://docutils.sourceforge.io/docs/howto/html-stylesheets.html for how to
 customize this style sheet.
@@ -274,7 +275,7 @@
   margin-left: 2em ;
   margin-right: 2em }
 
-pre.code .ln { color: grey; } /* line numbers */
+pre.code .ln { color: gray; } /* line numbers */
 pre.code, code { background-color: #eeeeee }
 pre.code .comment, code .comment { color: #5C6576 }
 pre.code .keyword, code .keyword { color: #3B0D06; font-weight: bold }
@@ -300,7 +301,7 @@
 span.pre {
   white-space: pre }
 
-span.problematic {
+span.problematic, pre.problematic {
   color: red }
 
 span.section-subtitle {
@@ -457,6 +458,9 @@ <h1><a class="toc-backref" href="#toc-entry-2">Configuration</a></h1>
 and <tt class="docutils literal"><span class="pre">--workers</span></tt> greater than 1. <a class="footnote-reference" href="#footnote-1" id="footnote-reference-1">[1]</a></li>
 </ul>
 </li>
+<li>Keep in mind that the number of workers should be greater than the number of
+channels. <tt class="docutils literal">queue_job</tt> will reuse normal Odoo workers to process jobs. It
+will not spawn its own workers.</li>
 <li>Using the Odoo configuration file:</li>
 </ul>
 <pre class="code ini literal-block">
@@ -470,6 +474,7 @@ <h1><a class="toc-backref" href="#toc-entry-2">Configuration</a></h1>
 </span><span class="na">channels</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">root:2</span>
 </pre>
 <ul class="simple">
+<li>Environment variables have priority over the configuration file.</li>
 <li>Confirm the runner is starting correctly by checking the odoo log file:</li>
 </ul>
 <pre class="code literal-block">
@@ -954,7 +959,9 @@ <h2><a class="toc-backref" href="#toc-entry-17">Contributors</a></h2>
 <div class="section" id="maintainers">
 <h2><a class="toc-backref" href="#toc-entry-18">Maintainers</a></h2>
 <p>This module is maintained by the OCA.</p>
-<a class="reference external image-reference" href="https://odoo-community.org"><img alt="Odoo Community Association" src="https://odoo-community.org/logo.png" /></a>
+<a class="reference external image-reference" href="https://odoo-community.org">
+<img alt="Odoo Community Association" src="https://odoo-community.org/logo.png" />
+</a>
 <p>OCA, or the Odoo Community Association, is a nonprofit organization whose
 mission is to support the collaborative development of Odoo features and
 promote its widespread use.</p>