few edits

Author: harikrishna-patnala

source/_static/images/Cloudstack-create-sshkeypair.png

@@ -285,6 +285,20 @@ Existing `MAAS consumer` token can be used or a new API key can be generated by
 
 Note down the **key** value.
 
+You can verify the MAAS API key and connectivity from the CloudStack Management Server by using the MAAS CLI as shown below (replace the example values with your own):
+
+.. code-block:: bash
+
+    maas login admin http://<MAAS-ENDPOINT>:5240/MAAS <API_KEY>
+
+    # Example:
+    maas login admin http://10.0.80.47:5240/MAAS QqeFTc4fvz9qQyPzGy:UUGKTDf6VwPVDnhXUp:wtAZk6rKeHrFLyDQD9sWcASPkZVSMu6a
+
+    # Verify MAAS connectivity and list machines
+    maas admin machines read | jq '.[].system_id'
+
+If the connection is successful, the command will list all registered machine system IDs from MAAS.
+
 Install required Python libraries
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -335,24 +349,27 @@ To set up the MaaS Extension, follow these steps in CloudStack:
    * **release**: Numeric OS release (e.g., `20.04`, `22.04`)
    * **architecture**: Image architecture name as listed in MaaS (e.g., `amd64/ga-20.04`, `amd64/hwe-22.04`, `amd64/generic`)
 
+   MAAS uses only distro_series to identify the operating system for Ubuntu-based images (for example, focal, jammy).
+   Do not specify both release and distro_series, if both are provided, MAAS will ignore release.
+
    Example configurations:
 
    .. code-block:: text
 
-       os=ubuntu
-       distro_series=focal
-       release=20.04
-       architecture=amd64/ga-20.04
+      # Ubuntu 20.04 (Focal)
+      os=ubuntu
+      distro_series=focal
+      architecture=amd64/ga-20.04
 
-       os=ubuntu
-       distro_series=jammy
-       release=22.04
-       architecture=amd64/hwe-22.04
+      # Ubuntu 22.04 (Jammy)
+      os=ubuntu
+      distro_series=jammy
+      architecture=amd64/hwe-22.04
 
-       os=centos
-       distro_series=8
-       release=8
-       architecture=amd64/generic
+      # CentOS 8
+      os=centos
+      release=8
+      architecture=amd64/generic
 
    |MaaS-add-template.png|
 
@@ -366,8 +383,8 @@ To set up the MaaS Extension, follow these steps in CloudStack:
 
    Operations **Start**, **Stop**, **Reboot**, and **Delete** can be performed on the Instance from CloudStack.
 
-Additional Notes and Tested Scenarios
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Configuring Networking and additional details
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The MaaS scenarios have been tested and verified with a Shared Network setup in CloudStack, using the MAAS Orchestrator Extension.
 Please find some additional notes with respect to the networking and access related configuration as below,
@@ -417,8 +434,6 @@ Please find some additional notes with respect to the networking and access rela
    1. Navigate to **Compute → SSH Keypairs → Create SSH Keypair**.
    2. Save the generated **private key** for later use (CloudStack stores only the public key).
 
-   |Cloudstack-create-sshkeypair.png|
-
    **In MAAS**
 
    1. Navigate to **Admin → SSH Keys → Import**.
@@ -456,5 +471,4 @@ Please find some additional notes with respect to the networking and access rela
 .. |MaaS-subnet-configuration.png| image:: /_static/images/MaaS-subnet-configuration.png
 .. |MaaS-add-reserve-iprange.png| image:: /_static/images/MaaS-add-reserve-iprange.png
 .. |MaaS-disable-dhcp.png| image:: /_static/images/MaaS-disable-dhcp.png
-.. |Cloudstack-create-sshkeypair.png| image:: /_static/images/Cloudstack-create-sshkeypair.png
 .. |MaaS-add-sshkeypair.png| image:: /_static/images/MaaS-add-sshkeypair.png