From 9672dd44f2b8d8562c0c82dab5d06855c675a39b Mon Sep 17 00:00:00 2001
From: Alexei Znamensky <russoz@gmail.com>
Date: Sun, 27 Jul 2025 17:17:19 +1200
Subject: [PATCH] doc style adjustments: modules t*

---
 plugins/modules/telegram.py  |  2 +-
 plugins/modules/terraform.py | 16 ++++++++--------
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/plugins/modules/telegram.py b/plugins/modules/telegram.py
index 6773f48bf5..abaa72c83e 100644
--- a/plugins/modules/telegram.py
+++ b/plugins/modules/telegram.py
@@ -21,7 +21,7 @@ description:
   - Send notifications using telegram bot, to a verified group or user.
   - Also, the user may try to use any other telegram bot API method, if you specify O(api_method) argument.
 notes:
-  - You will require a telegram account and create telegram bot to use this module.
+  - You need a telegram account and create telegram bot to use this module.
 extends_documentation_fragment:
   - community.general.attributes
 attributes:
diff --git a/plugins/modules/terraform.py b/plugins/modules/terraform.py
index dd34ba9a0e..fde826ed4f 100644
--- a/plugins/modules/terraform.py
+++ b/plugins/modules/terraform.py
@@ -58,19 +58,19 @@ options:
   purge_workspace:
     description:
       - Only works with state = absent.
-      - If true, the workspace will be deleted after the "terraform destroy" action.
-      - The 'default' workspace will not be deleted.
+      - If V(true), the O(workspace) is deleted after the C(terraform destroy) action.
+      - If O(workspace=default) then it is not deleted.
     default: false
     type: bool
   plan_file:
     description:
-      - The path to an existing Terraform plan file to apply. If this is not specified, Ansible will build a new TF plan and
-        execute it. Note that this option is required if 'state' has the 'planned' value.
+      - The path to an existing Terraform plan file to apply. If this is not specified, Ansible builds a new TF plan and execute
+        it. Note that this option is required if O(state=planned).
     type: path
   state_file:
     description:
       - The path to an existing Terraform state file to use when building plan. If this is not specified, the default C(terraform.tfstate)
-        will be used.
+        is used.
       - This option is ignored when plan is specified.
     type: path
   variables_files:
@@ -91,7 +91,7 @@ options:
       - Ansible dictionaries are mapped to terraform objects.
       - Ansible lists are mapped to terraform lists.
       - Ansible booleans are mapped to terraform booleans.
-      - B(Note) passwords passed as variables will be visible in the log output. Make sure to use C(no_log=true) in production!.
+      - B(Note) passwords passed as variables are visible in the log output. Make sure to use C(no_log=true) in production!.
     type: dict
   complex_vars:
     description:
@@ -104,7 +104,7 @@ options:
     version_added: 5.7.0
   targets:
     description:
-      - A list of specific resources to target in this plan/application. The resources selected here will also auto-include
+      - A list of specific resources to target in this plan/application. The resources selected here are also auto-include
         any dependencies.
     type: list
     elements: str
@@ -120,7 +120,7 @@ options:
     type: int
   force_init:
     description:
-      - To avoid duplicating infra, if a state file cannot be found this will force a C(terraform init). Generally, this should
+      - To avoid duplicating infra, if a state file cannot be found this forces a C(terraform init). Generally, this should
         be turned off unless you intend to provision an entirely new Terraform deployment.
     default: false
     type: bool