diff --git a/proxmox/terraform/README.md b/proxmox/terraform/README.md
--- a/proxmox/terraform/README.md
+++ b/proxmox/terraform/README.md
@@ -4,8 +4,6 @@
 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 setup.sh
 ```
 
-## provision new vm
+## provision infra
 
 ```
 terraform init
@@ -34,11 +32,14 @@
 
 # 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 @@
 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
--- a/proxmox/terraform/prepare-workstation.md
+++ b/proxmox/terraform/prepare-workstation.md
@@ -14,7 +14,7 @@
 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/
 ```