From 3406288644f75dd5152c35c7b42e477ad8538ff3 Mon Sep 17 00:00:00 2001
From: "patchback[bot]" <45432694+patchback[bot]@users.noreply.github.com>
Date: Sun, 10 Aug 2025 13:51:52 +0200
Subject: [PATCH] [PR #10618/4e8a6c03 backport][stable-11] infinity: improve RV
 descriptions (#10624)

infinity: improve RV descriptions (#10618)

(cherry picked from commit 4e8a6c03ddfc8a014d5eb880cc359ce1dd4c63b5)

Co-authored-by: Alexei Znamensky <103110+russoz@users.noreply.github.com>
---
 plugins/modules/infinity.py | 42 ++++++++++++++++++++++++-------------
 1 file changed, 27 insertions(+), 15 deletions(-)

diff --git a/plugins/modules/infinity.py b/plugins/modules/infinity.py
index cc54b46c51..7d5c6962bc 100644
--- a/plugins/modules/infinity.py
+++ b/plugins/modules/infinity.py
@@ -110,26 +110,38 @@ network_id:
   type: str
   sample: '1501'
 ip_info:
-  description: When reserve next available IP address from a network, the IP address info is returned.
+  description:
+    - When reserve next available IP address from a network, the IP address info is returned.
+    - Please note that the value is a B(string) containing JSON data.
   returned: success
   type: str
-  sample: '{"address": "192.168.10.3", "hostname": "", "FQDN": "", "domainname": "", "id": 3229}'
+  sample: >-
+    {
+      "address": "192.168.10.3",
+      "hostname": "",
+      "FQDN": "",
+      "domainname": "",
+      "id": 3229
+    }
 network_info:
-  description: When reserving a LAN network from a Infinity supernet by providing network_size, the information about the
-    reserved network is returned.
+  description:
+    - When reserving a LAN network from a Infinity supernet by providing network_size, the information about the reserved
+      network is returned.
+    - Please note that the value is a B(string) containing JSON data.
   returned: success
   type: str
-  sample: {
-    "network_address": "192.168.10.32/28",
-    "network_family": "4",
-    "network_id": 3102,
-    "network_size": null,
-    "description": null,
-    "network_location": "3085",
-    "ranges": {"id": 0, "name": null, "first_ip": null, "type": null, "last_ip": null},
-    "network_type": "lan",
-    "network_name": "'reserve_new_ansible_network'"
-  }
+  sample: >-
+    {
+      "network_address": "192.168.10.32/28",
+      "network_family": "4",
+      "network_id": 3102,
+      "network_size": null,
+      "description": null,
+      "network_location": "3085",
+      "ranges": {"id": 0, "name": null, "first_ip": null, "type": null, "last_ip": null},
+      "network_type": "lan",
+      "network_name": "'reserve_new_ansible_network'"
+    }
 """