From f23e78fd31da8002f9fdf295fad0857d5fb65c91 Mon Sep 17 00:00:00 2001
From: "Marco Emilio \"sphakka\" Poleggi" <marcoep@ieee.org>
Date: Sun, 10 Nov 2024 20:46:51 +0100
Subject: [PATCH] FIxed some typos

Signed-off-by: Marco Emilio "sphakka" Poleggi <marcoep@ieee.org>
---
 README.md | 36 ++++++++++++++++++------------------
 1 file changed, 18 insertions(+), 18 deletions(-)

diff --git a/README.md b/README.md
index 23cb62c..7d7ed5f 100644
--- a/README.md
+++ b/README.md
@@ -42,7 +42,7 @@ lcl$ ansible --version
 
   1. Create a VM instance with the following characteristics:
      - OS: any GNU/Linux distribution using the `apt` package manager. Tested
-       on Debian 11 (Bullseye) and Ubuntu Server 20.04 LTS
+       on Debian 11 and 12
      - type: the smallest capable of running the above OS. 1 core, 1GB RAM,
        10GB virtual disk should be enough.
      - security group/policy: the one you created above
@@ -239,11 +239,11 @@ Now, open the playbook file `playbooks/web.yml`. It should look like:
 ```
 
 :bulb: Notice the following aspects:
-  * The target `hosts`: it can be a group.
+  * The target `hosts` key can be assigned a group.
   * The `became` key instructs Ansible to run as the *superuser* (normally
     `root`) in the managed hosts.
   * Each task uses a different *builtin module*. Can you name them?
-  * Builtin modules have self-explanatory:
+  * Builtin modules have self-explanatory options:
       * some of them are system-agnostic, e.g., the `copy` one. :question: Which other?
       * others depend on the target OS. :question: Which ones?
   * We can use `tags` to select specific tasks. E.g., with:
@@ -338,7 +338,7 @@ If everything goes well, the output should confirm a task recap of: ok=6,
 changed=5.
 
 Point your Web browser to the address of the managed server (mind that we are
-not using SSL): `http://<VM-DNS-name-or-IP-address>`. You should see the
+using plain `http`): `http://<VM-DNS-name-or-IP-address>`. You should see the
 homepage showing "nginx, configured by Ansible".
 
 
@@ -376,7 +376,7 @@ desired state as *ok*.
   1. Do something more drastic like completely removing the homepage
      `index.html` and repeat the previous question.
      1. :question: What happened this time?
-  1. Notwithstanding the idempotence principle, there's task which is always
+  1. Notwithstanding the idempotence principle, there's a task which is always
      marked as "changed".
      1. :question: Which one? Do you have an explanation?
 
@@ -429,7 +429,7 @@ Here's an example:
     - name: baz
       ...
       # triggered by signal 'a_signal'
-      listen: signal
+      listen: a_signal
 ```
 
 
@@ -512,7 +512,7 @@ which makes Ansible ignore it unless explicitly requested:
 
 Then, you'd call it like this:
 ``` shell
-lcl$ ansible-playbook [--check] YOUR_PLAYBOOK --tags='revert all'
+lcl$ ansible-playbook [--check] YOUR_PLAYBOOK --tags='revert_all'
 ```
 
 :bulb: Notice how, in normal conditions, never-tagged tasks are not shown in
@@ -573,11 +573,11 @@ restart" dummy task that triggers the handler "restart nginx" on demand.
 
 Suppose you have an out-of-tree (i.e., not available via the target host
 package manager) complex application composed of several modules which must
-be, first, installed, then, deployed in the correct order. The correct
-approach is to separate installation tasks from deployment handlers, and we
-must ensure redeployment of dependent modules whenever a dependency has
-changed. A possible solution is using *cascading* handlers: indeed, a handler
-can notify another one!
+be, first, installed, then, deployed in the correct order. A good approach is
+to separate installation tasks from deployment handlers, and we must ensure
+redeployment of dependent modules whenever a dependency has changed. A
+possible solution is using *cascading* handlers: indeed, a handler can notify
+another one!
 
 For the sake of simplicity, let's prepare a dummy 2-module applications:
 
@@ -602,7 +602,7 @@ some rescue operations:
         copy:
           src: files/app2
           dest: /tmp/app2
-          notify: deploy app2
+        notify: deploy app2
 
     # Run as the default user
     become: false
@@ -627,9 +627,9 @@ handler must notify the second one. Let's add the above snippet to our
 `playbooks/web.yml` and try it.
 
 :bulb: Notice the `debug` feature above. Also, to see the echo messages you
-have to use the `-vv` switch.
+have to use the `--verbose` switch.
 
-At the first installation, we should get both installation task changed
+At the first installation, we should get both installation tasks changed
 **and** both handlers triggered, which makes 4 changes:
 ``` shell
 lcl$ ansible-playbook -v playbooks/web.yml
@@ -689,13 +689,13 @@ service.
 :hammer_and_wrench: **Over to you now.** Prepare another playbook based on the
 `playbooks/kind-metallb.yml` boilerplate.
 
-:bulb: To go as quick as possible, provision a 2-nodes KinD cluster with 2
+:bulb: To go as quick as possible, provision a 2-node KinD cluster with 2
 http-echo pods on the only worker node.
 
 Once done, use the following test track to finalize your workflow:
-  1. The first playbook run must install, provision and deploy everything. The
+  1. The first playbook run shall install, provision and deploy everything. The
      http-echo app shall respond with different messages.
-  1. Changing any configuration file must trigger a cascading handler series. E.g.:
+  1. Changing any configuration file shall trigger a cascading handler series. E.g.:
      - KinD configuration triggers all operations (apart from package installations).
      - `metallb-native.yaml` triggers a whole app stack redeployment. :bulb:
        `kubectl apply` can be called on a running stack.
-- 
GitLab