Backport/2.9/docs (#63521)

* Update stat.py (#63289)
Reword awkward documentation language.

(cherry picked from commit b46299ff86)

* Update win_disk_facts.py example (#63266)
Fix incorrect index for second disk (should be `disks[1]` not `disks[0]`)

(cherry picked from commit ce1c8c24f7)

* Fix broken link (#63185)

(cherry picked from commit 021d095625)

* Typo on line 161 (#63133)
fix module name for azure_rm_manageddisk in one example

(cherry picked from commit 81a614684a)

* docs: add Centos and Ubuntu to examples for playbook conditionals (#63085)

Co-Authored-By: Sandra McCann <samccann@redhat.com>
(cherry picked from commit 19587b35da)

* Spot instance code error (#63246)
Adds 'instance_initiated_shutdown_behavior: terminate' to spot instance example for greater efficiency.

(cherry picked from commit 5ed163ce3f)

* Pass a JSON file to the Lambda's payload (#63261)
* Add an example of passing a JSON file to the Lambda's payload
Events passed to Lambda are commonly in JSON format, the change provides an example of using JSON file as an alternative to the inline YAML payload in the other examples.

(cherry picked from commit 1d5206f53e)

* Update ec2.py (#63260)
Change the explanation of spot_wait_timeout

(cherry picked from commit 719170e5c1)

* fix aruba_config examples (#63136)

(cherry picked from commit 6ff5968781)

* [ec2_launch_template] Update examples (#63152)
- Update tasks names for existing examples
- Add a new example showing how to delete a launch template

(cherry picked from commit 32980f214a)

docs/docsite/rst/dev_guide/testing_units.rst

@@ -76,10 +76,10 @@ install all the required dependencies needed for unit tests. For example:
    When using ``ansible-test`` with ``--tox`` requires tox >= 2.5.0
 
 
-The full list of requirements can be found at `test/runner/requirements
-<https://github.com/ansible/ansible/tree/devel/test/runner/requirements>`_. Requirements
+The full list of requirements can be found at `test/lib/ansible_test/_data/requirements
+<https://github.com/ansible/ansible/tree/devel/test/lib/ansible_test/_data/requirements>`_. Requirements
 files are named after their respective commands. See also the `constraints
-<https://github.com/ansible/ansible/blob/devel/test/runner/requirements/constraints.txt>`_
+<https://github.com/ansible/ansible/blob/devel/test/lib/ansible_test/_data/requirements/constraints.txt>`_
 applicable to all commands.
 
 

docs/docsite/rst/user_guide/playbooks_conditionals.rst

@@ -352,6 +352,7 @@ Possible values (sample, not complete list)::
     Archlinux
     ClearLinux
     Coreos
+    CentOS
     Debian
     Fedora
     Gentoo
@@ -363,6 +364,7 @@ Possible values (sample, not complete list)::
     Slackware
     SMGL
     SUSE
+    Ubuntu
     VMwareESX
 
 .. See `OSDIST_LIST`

lib/ansible/modules/cloud/amazon/ec2.py

@@ -118,7 +118,7 @@ options:
   spot_wait_timeout:
     version_added: "1.5"
     description:
-      - How long to wait for the spot instance request to be fulfilled.
+      - How long to wait for the spot instance request to be fulfilled. Affects 'Request valid until' for setting spot request lifespan.
     default: 600
     type: int
   count:
@@ -370,6 +370,7 @@ EXAMPLES = '''
     vpc_subnet_id: subnet-29e63245
     assign_public_ip: yes
     spot_launch_group: report_generators
+    instance_initiated_shutdown_behavior: terminate
 
 # Examples using pre-existing network interfaces
 - ec2:

lib/ansible/modules/cloud/amazon/ec2_launch_template.py

@@ -286,24 +286,29 @@ options:
 '''
 
 EXAMPLES = '''
-- name: Make instance with an instance_role
+- name: Create an ec2 launch template
   ec2_launch_template:
-    name: "test-with-instance-role"
-    image_id: "ami-foobarbaz"
+    name: "my_template"
+    image_id: "ami-04b762b4289fba92b"
     key_name: my_ssh_key
     instance_type: t2.micro
     iam_instance_profile: myTestProfile
     disable_api_termination: true
 
-- name: Make one with a different instance type, but leave the older version as default
+- name: >
+    Create a new version of an existing ec2 launch template with a different instance type,
+    while leaving an older version as the default version
   ec2_launch_template:
-    name: "test-with-instance-role"
-    image_id: "ami-foobarbaz"
+    name: "my_template"
     default_version: 1
-    key_name: my_ssh_key
     instance_type: c5.4xlarge
-    iam_instance_profile: myTestProfile
-    disable_api_termination: true
+
+- name: Delete an ec2 launch template
+  ec2_launch_template:
+    name: "my_template"
+    state: absent
+
+# This module does not yet allow deletion of specific versions of launch templates
 '''
 
 RETURN = '''

lib/ansible/modules/cloud/amazon/execute_lambda.py

@@ -106,7 +106,13 @@ EXAMPLES = '''
     wait: true
     tail_log: true
   register: response
-  # the response will have a `logs` key that will contain a log (up to 4KB) of the function execution in Lambda.
+  # the response will have a `logs` key that will contain a log (up to 4KB) of the function execution in Lambda
+
+# Pass the Lambda event payload as a json file.
+- execute_lambda:
+    name: test-function
+    payload: "{{ lookup('file','lambda_event.json') }}"
+  register: response
 
 - execute_lambda:
     name: test-function

lib/ansible/modules/cloud/azure/azure_rm_manageddisk.py

@@ -158,7 +158,7 @@ EXAMPLES = '''
         disk_size_gb: 4
 
     - name: Delete managed disk
-      azure_rm_manage_disk:
+      azure_rm_manageddisk:
         name: mymanageddisk
         location: eastus
         resource_group: myResourceGroup

lib/ansible/modules/files/stat.py

@@ -342,7 +342,7 @@ stat:
             sample: False
             version_added: 2.2
         executable:
-            description: Tells you if the invoking user has the execute the path
+            description: Tells you if the invoking user has execute permission on the path
             returned: success, path exists and user can execute the path
             type: bool
             sample: False

lib/ansible/modules/network/aruba/aruba_config.py

@@ -184,7 +184,7 @@ EXAMPLES = """
 - name: diff the running-config against a provided config
   aruba_config:
     diff_against: intended
-    intended: "{{ lookup('file', 'master.cfg') }}"
+    intended_config: "{{ lookup('file', 'master.cfg') }}"
 
 - name: configure interface settings
   aruba_config:

lib/ansible/modules/windows/win_disk_facts.py

@@ -50,7 +50,7 @@ EXAMPLES = r'''
 
 - name: Output second disk serial number
   debug:
-    var: ansible_facts.disks[0].serial_number
+    var: ansible_facts.disks[1].serial_number
 '''
 
 RETURN = r'''