Merge pull request #39 from kmacedovarela/pre-reqs-cleanup

chapters 01 and 02: adding versions to the pre-reqs, polishing the te…

chapter-1/README.md

@@ -4,6 +4,19 @@ Thanks to the fantastic cloud-native community, you can read these tutorials in
 
 - [Chinese `zh-cn`](README.zh-cn.md) 🇨🇳
 
+## Pre-requisites for the tutorials
+
+You'll need the tools below to follow the step-by-step tutorials linked in the book:
+- [Docker](https://docs.docker.com/engine/install/), v24.0.2
+- [kubectl](https://kubernetes.io/docs/tasks/tools/), Client v1.27.3
+- [KinD](https://kind.sigs.k8s.io/docs/user/quick-start/), v0.20.0
+- [Helm](https://helm.sh/docs/intro/install/), v3.12.3
+
+These are technologies and versions used when testing the tutorials.
+
+> [!Warning]
+> If you want to use other technologies, like [Podman](https://podman.io/) instead of Docker, it should be possible as there is nothing specific to Docker.
+
 ## Conference Application Scenario
 
 The application that we will modify and use throughout the book chapters represents a simple "walking skeleton", meaning that it is complex enough to allow us to test assumptions, tools, and frameworks. Still, it is not the final product that our customers will use. 
@@ -33,19 +46,6 @@ Every action in the application emits events. Hence, when a new proposal is subm
 
 ![events](imgs/events-backoffice.png)
 
-
-## Pre-requisites for the other chapters
-
-The following tools are required for the step-by-step tutorials linked in the book. 
-
-
-- [Docker](https://docs.docker.com/engine/install/)
-  - Note: You can try to use [Podman](https://podman.io/) as well, as there is nothing specific to Docker, but all the tutorials had been tested with Docker.
-- [kubectl](https://kubernetes.io/docs/tasks/tools/)
-- [KinD](https://kind.sigs.k8s.io/docs/user/quick-start/)
-- [Helm](https://helm.sh/docs/intro/install/) 
-
-
 ## Sum up and Contribute
 
 Do you want to improve this tutorial? Create an issue, message me on [Twitter](https://twitter.com/salaboy), or send a Pull Request.

chapter-2/README.md

@@ -11,9 +11,12 @@ Helm Charts can be published to Helm Chart repositories or also, since Helm 3.7
 
 Check the pre-requisites for all the tutorials [here](../chapter-1/README.md#pre-requisites-for-the-other-chapters)
 
-
 ## Creating a local cluster with Kubernetes KinD
 
+> [!Important]
+> Make sure you have the pre-requisites for all the tutorials. You can find them [here](../chapter-1/README.md#pre-requisites-for-the-tutorials).
+
+
 Create a KinD Cluster with three worker nodes and 1 Control Plane.
 
 ```