diff --git a/proxmox/terraform/README.md b/proxmox/terraform/README.md
index df451251a1bdb7512b284e5f1d78929135f89e8d..01c606c790f6fb7dc4c844dbc588cf7fba3a56bc 100644
--- a/proxmox/terraform/README.md
+++ b/proxmox/terraform/README.md
@@ -4,8 +4,6 @@ Terraform allows to transparently declare our infrastructure as code. Providing
 a (non-official so far) plugin, we can provision vm the same way for our rocq
 infra (proxmox)
 
-# The road so far
-
 ## Prepare workstation
 
 See prepare-workstation.md
@@ -25,7 +23,7 @@ source it in your current shell session.
 source setup.sh
 ```
 
-## provision new vm
+## provision infra
 
 ```
 terraform init
@@ -34,11 +32,14 @@ terraform apply
 
 # Details
 
-The provisioning is bootstraping vm declared in ".tf" files. It's using a base
-template (debian-9-template, debian-10-template) installed in the hypervisor.
-Instructions are detailed in the `init-template.md` file.
+The provisioning is bootstraping vms declared in ".tf" files (in dependency
+order if any).
+
+It's using a base template (either debian-9-template, debian-10-template)
+installed in the hypervisor. Instructions are detailed in the
+`init-template.md` file.
 
-# Init
+## Init
 
 This initializes your local copy with the necessary:
 
@@ -46,16 +47,15 @@ This initializes your local copy with the necessary:
 terraform init
 ```
 
-# Plan changes
+## Plan changes
 
-Compulse all *.tf files present in the folder, then compute a
-differential plan:
+Parse all *.tf files present in the folder, then compute a differential plan:
 
 ```
 terraform plan
 ```
 
-# Apply changes
+## Apply changes
 
 Propose to apply the plan to the infra (interactively):
 
diff --git a/proxmox/terraform/prepare-workstation.md b/proxmox/terraform/prepare-workstation.md
index 2355775fbc476708b515128c11f4d7deb35f81ce..8f8e4f428a2864d42a806852fb90a6f3e3558545 100644
--- a/proxmox/terraform/prepare-workstation.md
+++ b/proxmox/terraform/prepare-workstation.md
@@ -14,7 +14,7 @@ make setup
 make
 make install
 
-# Install so that terrafor actually sees the plugin
+# Install so that terraform actually sees the plugin
 mkdir -p ~/.terraform.d/plugins/linux_amd64
 cp -v ./bin/* ~/.terraform.d/plugins/linux_amd64/
 ```