Document changes proposed based on ssh feature access UX

docs/user_guide/additional_howtos/configure_ssh_public_keys.rst

@@ -8,6 +8,19 @@ Edge Manageability Framework allows you to add **public SSH keys** into a host d
    .. figure:: images/ssh_key_menu.png
       :alt: Public SSH keys
 
+#. You can edit and run the following example commands on a Linux\* or Mac\* machine to generate the SSH key pair:
+
+   .. code-block:: bash
+
+      ssh-keygen -t ed25519 -f ~/your_key_name  # Generates in ed25519 format
+      ssh-keygen -t ecdsa -b 521 -f ~/your_key_name # Generates in ecdsa-sha2-nistp521 format
+
+   .. note::
+
+      | Only **public key**-based authentication with the following SSH key algorithms are supported:
+      | * **ed25519**
+      | * **ecdsa-sha2-nistp521**
+
 #. Click **Add Key** to open the menu, add the **Key Name** and SSH **Public Key**, then click **Add**:
 
    .. figure:: images/add_ssh_key_menu.png
@@ -17,43 +30,31 @@ Edge Manageability Framework allows you to add **public SSH keys** into a host d
 
       The SSH **Key Name** will be used to establish the user account on the host. 
       Ensure that the provided name does not conflict with any restricted usernames (example: root, admin, and etc.)
-      in the Linux\* OS.
+      in the Linux or Mac OS.
 
    Once the key is added to the SSH key list, you can add it to a host when configuring it. Follow the 
    :doc:`/user_guide/set_up_edge_infra/provision_host` instructions to enable this.
 
 #. To delete an SSH key, click the **Delete** option under the **Actions** column next to the key you want to delete. 
-   A confirmation dialog will appear. Click **Delete** to confirm the deletion: .. note:: You cannot delete the SSH Key if it is associated with a          provisioned host.
+   A confirmation dialog will appear. Click **Delete** to confirm the deletion:
+
+    .. note:: You cannot delete the SSH key if it is associated with a provisioned host.
 
    .. figure:: images/delete_ssh_key_menu.png
       :alt: Delete SSH public key
 
-#. To view the list of hosts using the SSH key, click the **View Details** option under the **Actions** column next to the SSH key. A list of hosts currently using the SSH Key will be displayed:
+#. To view the list of hosts using the SSH key, click the **View Details** option under the **Actions** column next to the SSH key. A list of hosts currently using the SSH key will be displayed:
 
    .. figure:: images/ssh-key-using-host.png
       :alt: View hosts using SSH public key
 
-#. You can edit and run the following example commands on a Linux\* machine to generate the SSH key pair:
-
-   .. code-block:: bash
-
-      ssh-keygen -t ed25519 -f ~/your_key_name  # Generates in ed25519 format
-      ssh-keygen -t ecdsa -b 521 -f ~/your_key_name # Generates in ecdsa-sha2-nistp521 format
-
-   .. note::
-
-      | Only **Public Key** based authentication with the following SSH Key algorithms are supported:
-      | * **ed25519**
-      | * **ecdsa-sha2-nistp521**
-
-
 #. To access the host's console using SSH, run the following command:
 
    .. code-block:: bash
 
       ssh -i ~/your_private_key <key-name>@<host_ip_address>
 
-   Legend:
+   .. note::
       * **<key-name>** is the name provided when you add the SSH key.
       * **<host_ip_address>** is the IP address of the host. You can get the IP address through the **host** `View I/O Devices Details <./../set_up_edge_infra/provisioned_host_details.html#view-i-o-devices-details>`__ page of the web UI.