docs: Tweak README

Author: alessfg

README.md

@@ -18,62 +18,71 @@ This role installs NGINX Open Source, NGINX Plus, NGINX Agent or the NGINX Ampli
 
 ### NGINX
 
-Depending on your target NGINX use case, you might need to obtain some data before being able to use the role.
+Depending on your target NGINX use case, you might need to obtain a license or API key/token before being able to use the role:
 
-#### NGINX Open Source (NGINX OSS)
+- **NGINX Open Source (NGINX OSS):**
 
-You do not need to do anything beforehand if you want to install NGINX OSS.
+  You do not need to do anything beforehand if you want to install NGINX OSS.
 
-#### NGINX Plus
+- **NGINX Plus:**
 
-If you wish to install NGINX Plus using this role, you will need to obtain an NGINX Plus license beforehand.
+  If you wish to install NGINX Plus using this role, you will need to obtain an NGINX Plus license beforehand.
 
-#### NGINX Agent
+- **NGINX Agent:**
 
-If you wish to install and configure the NGINX Agent, you will need: to have previously set up a compatible control plane. Check out the [NGINX Agent docs](https://docs.nginx.com/nginx-agent/overview/) for more info.
+  If you wish to install and configure the NGINX Agent, you will need: to have previously set up a compatible control plane. Check out the [NGINX Agent docs](https://docs.nginx.com/nginx-agent/overview/) for more info.
 
-In addition, if you wish to connect the NGINX Agent to the NGINX One SaaS control plane available in the F5 Distributed Cloud, you will also need the data plane token provided by the NGINX One SaaS control plane.
+  In addition, if you wish to connect the NGINX Agent to the NGINX One SaaS control plane available in the F5 Distributed Cloud, you will also need the data plane token provided by the NGINX One SaaS control plane.
 
-#### NGINX Amplify
+- **NGINX Amplify:**
 
-If you wish to install the NGINX Amplify agent, you will need the API key provided within the NGINX Amplify SaaS console.
+  If you wish to install the NGINX Amplify agent, you will need the API key provided within the NGINX Amplify SaaS console.
 
 ### Ansible
 
+If you want to use this role, you will need to use a supported version of Ansible core and Jinja2 as well as a few Ansible collections.
+
+For ease of use, you can install and/or upgrade Ansible core, Jinja2, and the aforementioned Ansible collections by running the following four commands on your Ansible host:
+
+```bash
+pip install --upgrade -r https://raw.githubusercontent.com/nginxinc/ansible-role-nginx/main/.github/workflows/requirements/requirements_ansible.txt
+curl -O https://raw.githubusercontent.com/nginxinc/ansible-role-nginx/main/.github/workflows/requirements/requirements_collections.yml
+ansible-galaxy install --force -r requirements_collections.yml
+rm -f requirements_collections.yml
+```
+
+This will also ensure you are deploying/running this role with a fully tested version of the aforementioned packages/collections.
+
+#### Ansible core
+
 - This role is developed and tested with [maintained](https://docs.ansible.com/ansible/devel/reference_appendices/release_and_maintenance.html) versions of Ansible core and Python.
-- When using Ansible core, you will also need to install the following collections:
-
-    ```yaml
-    ---
-    collections:
-      - name: ansible.posix
-        version: 1.5.4
-      - name: community.general
-        version: 9.0.1
-      - name: community.crypto # Only required if you plan to install NGINX Plus
-        version: 2.20.0
-      - name: community.docker # Only required if you plan to use Molecule (see below)
-        version: 3.10.3
-    ```
-
-    > [!TIP]
-    > You can alternatively install the Ansible community distribution (what is known as the "old" Ansible) if you don't want to manage individual collections.
+- When using Ansible core, you will also need to install the following Ansible collections:
+
+  ```yaml
+  ---
+  collections:
+    - name: ansible.posix
+      version: 1.5.4
+    - name: community.general
+      version: 9.0.1
+    - name: community.crypto # Only required if you plan to install NGINX Plus
+      version: 2.20.0
+    - name: community.docker # Only required if you plan to use Molecule (see below)
+      version: 3.10.3
+  ```
+
 - You will need to run this role as a root user using Ansible's `become` parameter. Make sure you have set up the appropriate permissions on your target hosts.
-- Instructions on how to install Ansible can be found in the [Ansible website](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html#upgrading-ansible-from-version-2-9-and-older-to-version-2-10-or-later).
+- Instructions on how to install Ansible core can be found in the [Ansible](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html#upgrading-ansible-from-version-2-9-and-older-to-version-2-10-or-later) docs.
+- Instructions on how to install Ansible collections can be found in the [Ansible collections](https://docs.ansible.com/ansible/latest/collections_guide/collections_installing.html) guide.
+
+> [!TIP]
+> You can alternatively install the [Ansible community distribution](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html#selecting-an-ansible-package-and-version-to-install) (what is still known Ansible -- instead of Ansible core) if you don't want to manage individual collections.
 
 #### Jinja2
 
 - This role uses Jinja2 templates. Ansible core installs Jinja2 by default, but depending on your install and/or upgrade path, you might be running an outdated version of Jinja2. The minimum version of Jinja2 required for the role to properly function is `3.1`.
 - Instructions on how to install Jinja2 can be found in the [Jinja2 website](https://jinja.palletsprojects.com/en/3.1.x/intro/#installation).
 
-Alternatively, you can install `ansible-core`, a supported version of Jinja2, and the aforementioned collections by running the following three commands on your Ansible host:
-
-```bash
-pip install -r https://raw.githubusercontent.com/nginxinc/ansible-role-nginx/main/.github/workflows/requirements/requirements_ansible.txt
-curl -O https://raw.githubusercontent.com/nginxinc/ansible-role-nginx/main/.github/workflows/requirements/requirements_collections.yml
-ansible-galaxy install -r requirements_collections.yml
-```
-
 ### Testing suite (Optional)
 
 If you want to contribute to this role, you will also need to install Ansible Lint and Molecule.
@@ -88,11 +97,11 @@ If you want to contribute to this role, you will also need to install Ansible Li
   ansible-lint
   ```
 
-Alternatively, you can install Ansible Lint by running the following command on your Ansible host:
+- For ease of use, you can install and/or upgrade Ansible Lint by running the following command on your Ansible host:
 
-```bash
-pip install -r https://raw.githubusercontent.com/nginxinc/ansible-role-nginx/main/.github/workflows/requirements/requirements_ansible_lint.txt
-```
+  ```bash
+  pip install -r https://raw.githubusercontent.com/nginxinc/ansible-role-nginx/main/.github/workflows/requirements/requirements_ansible_lint.txt
+  ```
 
 #### Molecule (Optional)
 
@@ -108,11 +117,11 @@ pip install -r https://raw.githubusercontent.com/nginxinc/ansible-role-nginx/mai
   molecule test -s plus
   ```
 
-Alternatively, you can install Molecule and the aforementioned Molecule plugins and Docker Python SDK packages by running the following command on your Ansible host:
+- You can install and/or upgrade Molecule, the Molecule plugins package, and the Docker Python SDK by running the following command on your Ansible host:
 
-```bash
-pip install -r https://raw.githubusercontent.com/nginxinc/ansible-role-nginx/main/.github/workflows/requirements/requirements_molecule.txt
-```
+  ```bash
+  pip install --upgrade -r https://raw.githubusercontent.com/nginxinc/ansible-role-nginx/main/.github/workflows/requirements/requirements_molecule.txt
+  ```
 
 ## Role Installation
 
@@ -288,7 +297,7 @@ Ubuntu:
   - jammy (22.04)
 ```
 
-> [!WARNing]
+> [!WARNING]
 > At your own risk, you can also use this role to compile NGINX Open Source from source, install NGINX Open Source on "compatible" yet unsupported platforms, install NGINX from your respective distribution package manager, or install NGINX Open Source on BSD systems.
 
 ## Role Variables