win_product_facts: Fix RETURN information (#52058)

lib/ansible/modules/windows/win_product_facts.py

@@ -13,7 +13,7 @@ DOCUMENTATION = r'''
 module: win_product_facts
 short_description: Provides Windows product and license information
 description:
-- Provides Windows product information.
+- Provides Windows product and license information.
 version_added: '2.5'
 author:
 - Dag Wieers (@dagwieers)
@@ -26,13 +26,36 @@ EXAMPLES = r'''
 
 RETURN = r'''
 ansible_facts:
-  description: returned facts by this module
+  description: Dictionary containing all the detailed information about the Windows product and license.
   returned: always
-  type: dict
+  type: complex
-  sample:
+  contains:
-    ansible_os_product_id: 00326-10000-00000-AA698
+    ansible_os_license_channel:
-    ansible_os_product_key: T49TD-6VFBW-VV7HY-B2PXY-MY47H
+      description: The Windows license channel.
-    ansible_os_license_edition: Windows(R) ServerStandard edition
+      returned: always
-    ansible_os_license_channel: Volume:MAK
+      type: str
-    ansible_os_license_status: Licensed
+      sample: Volume:MAK
+      version_added: '2.8'
+    ansible_os_license_edition:
+      description: The Windows license edition.
+      returned: always
+      type: str
+      sample: Windows(R) ServerStandard edition
+      version_added: '2.8'
+    ansible_os_license_status:
+      description: The Windows license status.
+      returned: always
+      type: str
+      sample: Licensed
+      version_added: '2.8'
+    ansible_os_product_id:
+      description: The Windows product ID.
+      returned: always
+      type: str
+      sample: 00326-10000-00000-AA698
+    ansible_os_product_key:
+      description: The Windows product key.
+      returned: always
+      type: str
+      sample: T49TD-6VFBW-VV7HY-B2PXY-MY47H
 '''