deploy: 7b2c4aa

managed-namespace/index.html

@@ -3814,12 +3814,11 @@ <h1 id="managed-namespace">Managed Namespace<a class="headerlink" href="#managed
 <blockquote>
 <p>v2.5 and after</p>
 </blockquote>
-<p>You can install Argo in either cluster scoped or namespace scope configurations.
-This dictates if you must set-up cluster roles or normal roles.</p>
-<p>In namespace scope configuration, you must run both the Workflow Controller and
-Argo Server using <code>--namespaced</code>. If you would like to have the workflows running in a separate
-namespace, add <code>--managed-namespace</code> as well. (In cluster scope installation, don't include <code>--namespaced</code>
-or <code>--managed-namespace</code>.)</p>
+<p>You can install Argo in either namespace scoped or cluster scoped configurations.
+The main difference is whether you install Roles or ClusterRoles, respectively.</p>
+<p>In namespace scoped configuration, you must run both the Workflow Controller and Argo Server using <code>--namespaced</code>.
+If you want to run workflows in a separate namespace, add <code>--managed-namespace</code> as well.
+(In cluster scoped configuration, <em>don't</em> include <code>--namespaced</code> or <code>--managed-namespace</code>.)</p>
 <p>For example:</p>
 <div class="highlight"><pre><span></span><code><span class="w">      </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">args</span><span class="p">:</span>
 <span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">--configmap</span>
@@ -3830,7 +3829,7 @@ <h1 id="managed-namespace">Managed Namespace<a class="headerlink" href="#managed
 <span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">--managed-namespace</span>
 <span class="w">        </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">default</span>
 </code></pre></div>
-<p>Please mind that both cluster scoped and namespace scoped configurations require "admin" role because some custom resource (CRD) must be created (and CRD is always a cluster level object)</p>
+<p>Please note that both cluster scoped and namespace scoped configurations require "admin" roles to install because Argo's Custom Resource Definitions (CRDs) must be created (CRDs are cluster scoped objects).</p>
 <div class="admonition info">
 <p class="admonition-title">Example Use Case</p>
 <p>You can use a managed namespace install if you want some users or services to run Workflows without granting them privileges in the namespace where Argo Workflows is installed.