Update aws_ec2 documentation for the use_ssm_inventory option

Signed-off-by: Alina Buzachis <[email protected]>
ansible-collections · May 31, 2023 · 092990a · 092990a
1 parent 4d74baf
commit 092990a
Show file tree

Hide file tree

Showing 3 changed files with 9 additions and 2 deletions.
diff --git a/changelogs/fragments/20230531-aws_ec2-use_ssm_inventory_documentation.yml b/changelogs/fragments/20230531-aws_ec2-use_ssm_inventory_documentation.yml
@@ -0,0 +1,2 @@
+trivial:
+  - "Update the ``aws_ec2`` inventory plugins documentation for the ``use_ssm_inventory`` option."
diff --git a/docs/docsite/rst/aws_ec2_guide.rst b/docs/docsite/rst/aws_ec2_guide.rst
@@ -484,7 +484,9 @@ Now the output of ``ansible-inventory -i demo.aws_ec2.yml --list``:
 ``use_ssm_inventory``
 ---------------------
 
-``use_ssm_inventory: True`` will include SSM inventory variables into hostvars for ssm-configured instances.
+``use_ssm_inventory: True`` will allow to fetch EC2 instance information from the AWS Systems Manager (SSM) inventory service into hostvars. By leveraging the SSM inventory data, the ``use_ssm_inventory`` option provides additional details and attributes about the EC2 instances in your inventory.
+These details can include operating system information, installed software, network configurations, and custom inventory attributes defined in SSM.
+
 
 ``cache``
 ---------

diff --git a/plugins/inventory/aws_ec2.py b/plugins/inventory/aws_ec2.py
@@ -137,7 +137,10 @@
     version_added: 3.1.0
   use_ssm_inventory:
     description:
-      - Add SSM inventory information into hostvars.
+      - Allows to fetch EC2 instance information from the AWS Systems Manager (SSM) inventory service into hostvars.
+      - By leveraging the SSM inventory data, the I(use_ssm_inventory) option provides additional details and attributes
+        about the EC2 instances in your inventory. These details can include operating system information, installed software,
+        network configurations, and custom inventory attributes defined in SSM.
     type: bool
     default: False
     version_added: 6.0.0