From 21d43e6d94c3854fd6493329629efb0c4b847f43 Mon Sep 17 00:00:00 2001
From: Dag Wieers <dag@wieers.com>
Date: Wed, 13 Feb 2019 10:09:30 +0100
Subject: [PATCH] win_product_facts: Fix RETURN information (#52058)

---
 .../modules/windows/win_product_facts.py      | 41 +++++++++++++++----
 1 file changed, 32 insertions(+), 9 deletions(-)

diff --git a/lib/ansible/modules/windows/win_product_facts.py b/lib/ansible/modules/windows/win_product_facts.py
index c72d4c542f..0bd7f600a7 100644
--- a/lib/ansible/modules/windows/win_product_facts.py
+++ b/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
-  sample:
-    ansible_os_product_id: 00326-10000-00000-AA698
-    ansible_os_product_key: T49TD-6VFBW-VV7HY-B2PXY-MY47H
-    ansible_os_license_edition: Windows(R) ServerStandard edition
-    ansible_os_license_channel: Volume:MAK
-    ansible_os_license_status: Licensed
+  type: complex
+  contains:
+    ansible_os_license_channel:
+      description: The Windows license channel.
+      returned: always
+      type: str
+      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
 '''