Rename files and implement comments

edge_manager/edge_mgr_enroll.adoc → edge_manager/edge_mgr_enroll_devices.adoc

@@ -4,10 +4,9 @@
 To manage your devices with the {rhem}, you must enroll the devices to the {rhem} service.
 
 The first time the {rhem} agents runs on a device, the agent prepares for the enrollment process by generating a cryptographic key pair.
-The cryptographic key pair serves as the unique cryptographic identity of the device.
-The key pair consists of a public and a private key.
+The cryptographic key pair of the device consists of a public and a private key.
 The private key never leaves the device, so that the device cannot be duplicated or impersonated.
-The cryptographic identity is registered with the {rhem} service during enrollment and gets deleted during device decommissioning.
+The key pair is registered with the {rhem} service during enrollment and is deleted during decommissioning of the device.
 
 When the device is not yet enrolled, the agent performs service discovery to find its {rhem} service instance.
 Then, the device establishes a secure, mTLS-protected network connection to the service.
@@ -22,6 +21,13 @@ The device is not considered trusted and remains quarantined in a device lobby u
 For more information, read the following sections:
 //TODO Link to Enrollment, Requesting an enrollment certificate for early binding when docs are merged
 
+[#enroll-device-prereqs]
+== Prerequisites
+
+* You must install the {rhem} CLI.
+//TODO Add link to Installing CLI
+* You must log in to the {rhem} service.
+
 [#enroll-cli]
 == Enrolling devices using the CLI
 

edge_manager/edge_mgr_manage.adoc → edge_manager/edge_mgr_manage_devices.adoc

@@ -2,20 +2,21 @@
 = Managing devices
 
 After provisioning, you need to enroll your devices to manage them with the {rhem}.
-Device management includes organizing, monitoring, and updating the operating system and applications on your devices with the {rhem}.
+Device management includes organizing, monitoring, and updating your devices with the {rhem}.
 You can manage your devices individually or in a fleet.
 Managing your devices individually is advantageous in the following scenarios:
 
-* If your device configurations vary for each device.
-* If you need control over the order and timing of updates.
+* If a few devices have different configuration.
+* If you use external automation for updating the device.
 
 //For managing your devices in a fleet, see xref:../[]
 
 For more information, read the following sections:
 
-* xref:../edge_manager/edge_mgmt_manage_enroll#enroll[Enrollment]
-* xref:../edge_manager/edge_mgmt_manage_view#view-device[Viewing device inventory and device details]
-* xref:../edge_manager/edge_mgmt_manage_organize#labels[Labels and label selectors]
+* xref:../edge_manager/edge_mgr_enroll_devices#enroll[Enrolling devices]
+* xref:../edge_manager/edge_mgr_view_devices#view-device[Viewing device inventory and device details]
+* xref:../edge_manager/edge_mgr_label_devices#labels[Labels and label selectors]
+* xref:../edge_manager/edge_mgr_update_labels_on_devices#update-labels-cli[Updating labels using the CLI]
 ////
 TODO Add links to remaining sections
 * xref:../edge_manager/edge_mgmt_manage_update_os#update-os[Updating the operating system]

edge_manager/edge_mgr_view.adoc → edge_manager/edge_mgr_view_devices.adoc

@@ -8,6 +8,7 @@ To obtain more information about the devices in your inventory, you can use the
 
 * You must install the {rhem} CLI.
 //TODO Add link to Installing CLI
+* You must log in to the {rhem} service.
 * You must enroll at least one device.
 
 [#view-device-details]

edge_manager/main.adoc

@@ -4,8 +4,8 @@ include::modules/common-attributes.adoc[]
 
 include::edge_mgr_intro.adoc[leveloffset=+1]
 include::edge_mgr_enable.adoc[leveloffset=+2]
-include::edge_mgr_manage.adoc[leveloffset=+2]
-include::edge_mgr_enroll.adoc[leveloffset=+3]
-include::edge_mgr_view.adoc[leveloffset=+3]
-include::edge_mgr_labels.adoc[leveloffset=+3]
-include::edge_mgr_update_labels.adoc[leveloffset=+3]
+include::edge_mgr_manage_devices.adoc[leveloffset=+2]
+include::edge_mgr_enroll_devices.adoc[leveloffset=+3]
+include::edge_mgr_view_devices.adoc[leveloffset=+3]
+include::edge_mgr_label_devices.adoc[leveloffset=+3]
+include::edge_mgr_update_labels_on_devices.adoc[leveloffset=+3]