zos_gather_facts - add sample output to RETURN docstring (#722)

* zos_gather_facts - add sample output to RETURN docstring Signed-off-by: Ketan Kelkar <[email protected]> * add changelog fragment Signed-off-by: Ketan Kelkar <[email protected]> * zos_gather_facts RETURN docstring - add sample sysplex_name and lpar_name values Signed-off-by: Ketan Kelkar <[email protected]> * Update generated module doc Signed-off-by: ddimatos <[email protected]> --------- Signed-off-by: Ketan Kelkar <[email protected]> Signed-off-by: ddimatos <[email protected]> Co-authored-by: ddimatos <[email protected]>
ansible-collections · Apr 7, 2023 · 1984769 · 1984769
1 parent 1123f97
commit 1984769
Show file tree

Hide file tree

Showing 3 changed files with 45 additions and 0 deletions.
diff --git a/changelogs/fragments/663-zos_gather_facts-update-docstring.yml b/changelogs/fragments/663-zos_gather_facts-update-docstring.yml
@@ -0,0 +1,2 @@
+trivial:
+- zos_gather_facts - add sample output to RETURN docstring. (https://github.com/ansible-collections/ibm_zos_core/pull/722)
diff --git a/docs/source/modules/zos_gather_facts.rst b/docs/source/modules/zos_gather_facts.rst
@@ -96,4 +96,28 @@ ansible_facts
 
   | **returned**: when collected
   | **type**: dict
+  | **sample**:
+
+    .. code-block:: json
+
+        [
+            {
+                "ansible_facts": {
+                    "arch_level": "2",
+                    "hw_name": "SYSZD6",
+                    "ipl_volume": "RES820",
+                    "lpar_name": "SVLLAB01",
+                    "primary_jes": "JES2",
+                    "product_mod_level": "00",
+                    "product_name": "z/OS",
+                    "product_owner": "IBM CORP",
+                    "product_release": "05",
+                    "product_version": "02",
+                    "smf_name": "3090",
+                    "sys_name": "EC33018A",
+                    "sysplex_name": "SVPLEX1",
+                    "vm_name": "EC33018A"
+                }
+            }
+        ]
 
diff --git a/plugins/modules/zos_gather_facts.py b/plugins/modules/zos_gather_facts.py
@@ -88,6 +88,25 @@
   description: Collection of facts that are gathered from the z/OS systems.
   returned: when collected
   type: dict
+  sample:
+    [
+        "ansible_facts": {
+            "arch_level": "2",
+            "hw_name": "SYSZD6",
+            "ipl_volume": "RES820",
+            "lpar_name": "SVLLAB01",
+            "primary_jes": "JES2",
+            "product_mod_level": "00",
+            "product_name": "z/OS",
+            "product_owner": "IBM CORP",
+            "product_release": "05",
+            "product_version": "02",
+            "smf_name": "3090",
+            "sys_name": "EC33018A",
+            "sysplex_name": "SVPLEX1",
+            "vm_name": "EC33018A"
+        }
+    ]
 """
 
 from fnmatch import fnmatch
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		trivial:
		- zos_gather_facts - add sample output to RETURN docstring. (https://github.com/ansible-collections/ibm_zos_core/pull/722)