edits

Author: paigecalvert

docs/partials/embedded-cluster/_add-nodes-air-gap.mdx

@@ -6,9 +6,9 @@
 
    1. In the **Add a Node** dialog, select one or more roles for the new node that you will join. If no custom roles are defined, the role selection will not appear and only the join command is displayed.
 
-     <img alt="Add node page in the Admin Console" src="/images/admin-console-add-node.png" width="600px"/>
+       <img alt="Add node page in the Admin Console" src="/images/admin-console-add-node.png" width="600px"/>
 
-     [View a larger version of this image](/images/admin-console-add-node.png)
+       [View a larger version of this image](/images/admin-console-add-node.png)
 
     1. Copy the join command.
 

docs/partials/embedded-cluster/_add-nodes.mdx

@@ -6,9 +6,9 @@
 
    1. In the **Add a Node** dialog, select one or more roles for the new node that you will join. If no custom roles are defined, the role selection will not appear and only the join command is displayed.
 
-     <img alt="Add node page in the Admin Console" src="/images/admin-console-add-node.png" width="600px"/>
+       <img alt="Add node page in the Admin Console" src="/images/admin-console-add-node.png" width="600px"/>
 
-     [View a larger version of this image](/images/admin-console-add-node.png)
+       [View a larger version of this image](/images/admin-console-add-node.png)
 
     1. Copy the join command.
 

docs/vendor/embedded-overview.mdx

@@ -168,22 +168,24 @@ Skipping host preflight checks is _not_ recommended for production installations
 
 This section describes managing nodes in clusters created with Embedded Cluster.
 
-### Managing Nodes
+### Ading Nodes
 
-Users can add and manage nodes with Embedded Cluster from the Admin Console.
+Users can add nodes to a cluster with Embedded Cluster from the Admin Console. The Admin Console provides the join command used to add nodes to the cluster.
 
 For more information, see [Adding and Managing Nodes with Embedded Cluster](/enterprise/embedded-manage-nodes).
 
+### Defining Node Roles
+
+You can define node roles in the Embedded Cluster Config. In multi-node clusters, roles are used to determine which nodes run the Kubernetes control plane, and to assign application workloads to particular nodes. Users can then select and assign one or more roles to a node when it is joined to the cluster.
+
+For more information, see [roles](/reference/embedded-config#roles) in _Embedded Cluster Config_.
+
 ### High Availability for Multi-Node Clusters (Alpha)
 
 Multi-node clusters are not highly available by default. After three controller nodes are present in the cluster, high availability (HA) can be enabled.
 
 For more information about creating HA multi-node clusters with Embedded Cluster, see [Enable High Availability for Multi-Node Clusters (Alpha)](/enterprise/embedded-manage-nodes#ha) in _Adding and Managing Nodes with Embedded Cluster_.
 
-### Defining Custom Node Roles
-
-You can define custom node roles in the Embedded Cluster Config to support installations in multi-node clusters.
-
 ## (Optional) Serve Installation Assets Using the Vendor API
 
 To install with Embedded Cluster, you need to download the Embedded Cluster installer binary and a license. Air gap installations also require an air gap bundle. Some vendors already have a portal where their customers can log in to access documentation or download artifacts. In cases like this, you can serve the Embedded Cluster installation essets yourself using the Replicated Vendor API, rather than having customers download the assets from the Replicated app service using a curl command during installation.