From 0193be6bc229a0d82f6d7660138df2310a30239a Mon Sep 17 00:00:00 2001
From: Jules van Rie <jules@vanrie.be>
Date: Thu, 17 Sep 2026 19:58:00 +0200
Subject: [PATCH 01/16] Simplify Homebrew given Intel Mac support dropped

Always add Homebrew to PATH:
The condition is no longer relevant. The only time we didn't have to add it was when Homebrew installed to /usr/local, i.e. on Intel Macs.

Remove the failure catch about /usr/local:
Same reason: this only happens om Intel Macs.

Note: Copilot translated to Chinese for me. I reverse translated through Google Translate to check.
---
 _partials/cn/macos_homebrew.md | 14 +++-----------
 _partials/es/macos_homebrew.md | 14 ++------------
 _partials/fr/macos_homebrew.md | 14 ++------------
 _partials/macos_homebrew.md    | 17 ++---------------
 _partials/pt/macos_homebrew.md | 17 ++---------------
 5 files changed, 11 insertions(+), 65 deletions(-)

diff --git a/_partials/cn/macos_homebrew.md b/_partials/cn/macos_homebrew.md
index 56562a5e..9f88ed4a 100644
--- a/_partials/cn/macos_homebrew.md
+++ b/_partials/cn/macos_homebrew.md
@@ -12,17 +12,16 @@
 
 :warning: 当你输入你的密码的时候，屏幕上不会有任何的显示，**这是正常的**。这是一个安全保护的设置，来隐藏你整个密码，包括它的长度。你可以放心的输入你的密码，结束后按下`Enter`就可以了。
 
-:warning: 如果你看到了下面的警告:point_down:，运行`Next steps`下面的两个命令把Homebrew加到你的PATH里。
+如果你已经有了Homebrew,终端会告诉你的。那么一切正常，你可以继续接下来的步骤。
+
+Homebrew安装完成后，运行以下两个命令，将其添加到你的`PATH`中：
 
-![macOS Homebrew installation warning](images/macos_homebrew_warning.png)
 
 ```bash
-# ⚠️ Only execute these commands if you saw this warning ☝
 echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
 eval "$(/opt/homebrew/bin/brew shellenv)"
 ```
 
-如果你已经有了Homebrew,终端会告诉你的。那么一切正常，你可以继续接下来的步骤。
 
 接下来，让我们安装一些有用的软件：
 
@@ -30,13 +29,6 @@ eval "$(/opt/homebrew/bin/brew shellenv)"
 brew update
 ```
 
-如果你得到了`/usr/local must be writable`的报错，直接运行以下指令：
-
-```bash
-sudo chown -R $USER:admin /usr/local
-brew update
-```
-
 无论是否有这行报错，继续执行下方的指令（你可以一次性直接复制/粘贴下方所有行）
 
 ```bash
diff --git a/_partials/es/macos_homebrew.md b/_partials/es/macos_homebrew.md
index dbeb2ae0..f4a4e35c 100644
--- a/_partials/es/macos_homebrew.md
+++ b/_partials/es/macos_homebrew.md
@@ -12,31 +12,21 @@ Te pedirá que confirmes (presionando `Enter`) y también te pedirá la **contra
 
 :warning: Cuando escribas tu contraseña no verás nada en la pantalla. **Esto es normal**. Es una herramienta de seguridad para ocultar tanto el contenido de tu contraseña como su longitud. Simplemente escribe tu contraseña y presiona `Enter` al terminar.
 
-:warning: Si ves esta advertencia :point_down:, ejecuta los dos comandos de la sección `Next steps` para añadir Homebrew a tu PATH:
+Si ya tienes Homebrew instalado, el sistema te lo dirá y puedes continuar.
 
-![macOS Homebrew installation warning](images/macos_homebrew_warning.png)
+Una vez que Homebrew haya terminado de instalarse, ejecuta estos dos comandos para agregarlo a tu `PATH`:
 
 ```bash
-# ⚠️ Only execute these commands if you saw this warning ☝
 echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
 eval "$(/opt/homebrew/bin/brew shellenv)"
 ```
 
-Si ya tienes Homebrew instalado, el sistema te lo dirá y puedes continuar.
-
 Luego instala algunos programas útiles:
 
 ```bash
 brew update
 ```
 
-Si obtienes un error como este: `/usr/local must be writable`, ejecuta el código que te mostramos a continuación:
-
-```bash
-sudo chown -R $USER:admin /usr/local
-brew update
-```
-
 Ejecuta el siguiente código en tu terminal (puedes copiar y pegar todas las líneas de código al mismo tiempo):
 
 ```bash
diff --git a/_partials/fr/macos_homebrew.md b/_partials/fr/macos_homebrew.md
index 22fd861f..209cda03 100644
--- a/_partials/fr/macos_homebrew.md
+++ b/_partials/fr/macos_homebrew.md
@@ -12,31 +12,21 @@ On te demandera de confirmer (appuie sur `Enter`) et de saisir ton **mot de pass
 
 :warning: Lorsque tu saisiras ton mot de passe, rien ne s’affichera à l’écran ; **c’est normal**. Il s’agit d’une mesure de sécurité permettant de masquer ton mot de passe et sa longueur. Saisis simplement ton mot de passe, puis appuie sur `Enter`.
 
-:warning: Si tu vois cet avertissement :point_down:, exécute les deux commandes de la section `Next steps` pour ajouter Homebrew à ton PATH
+Si tu as déjà Homebrew, le système te l’indiquera. Continue.
 
-![macOS Homebrew installation warning](images/macos_homebrew_warning.png)
+Une fois l’installation de Homebrew terminée, exécute les deux commandes suivantes pour l’ajouter à ton `PATH` :
 
 ```bash
-# ⚠️ Only execute these commands if you saw this warning ☝
 echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
 eval "$(/opt/homebrew/bin/brew shellenv)"
 ```
 
-Si tu as déjà Homebrew, le système te l’indiquera. Continue.
-
 Installe ensuite quelques logiciels utiles :
 
 ```bash
 brew update
 ```
 
-Si tu vois apparaître une erreur `/usr/local must be writable`, exécute simplement :
-
-```bash
-sudo chown -R $USER:admin /usr/local
-brew update
-```
-
 Exécute les commandes suivantes dans le terminal (tu peux copier-coller toutes les lignes en une seule fois):
 
 ```bash
diff --git a/_partials/macos_homebrew.md b/_partials/macos_homebrew.md
index ed38947c..cfcf1235 100644
--- a/_partials/macos_homebrew.md
+++ b/_partials/macos_homebrew.md
@@ -12,34 +12,21 @@ This will ask for your confirmation (hit `Enter`) and your **macOS user account
 
 :warning: When you type your password, nothing will show up on the screen, **that's normal**. This is a security feature to mask not only your password as a whole but also its length. Just type your password and when you're done, press `Enter`.
 
-:warning: If you see this warning :point_down:, run the two commands in the `Next steps` section to add Homebrew to your PATH:
+If you already have Homebrew, it will tell you so, that's fine, go on.
 
-![macOS Homebrew installation warning](images/macos_homebrew_warning.png)
+Once Homebrew has finished installing, run these two commands to add it to your `PATH`:
 
 ```bash
-# ⚠️ Only execute these commands if you saw this warning ☝
 echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
 eval "$(/opt/homebrew/bin/brew shellenv)"
 ```
 
-If you already have Homebrew, it will tell you so, that's fine, go on.
-
 Then install some useful software:
 
 ```bash
 brew update
 ```
 
-If you get a `/usr/local must be writable` error, just run this:
-
-```bash
-sudo chown -R $USER:admin /usr/local
-```
-
-```bash
-brew update
-```
-
 Proceed running the following in the terminal (you can copy / paste all the lines at once):
 
 ```bash
diff --git a/_partials/pt/macos_homebrew.md b/_partials/pt/macos_homebrew.md
index be078d26..20198cc0 100644
--- a/_partials/pt/macos_homebrew.md
+++ b/_partials/pt/macos_homebrew.md
@@ -12,34 +12,21 @@ Isso solicitará sua confirmação (pressione `Enter`) e sua **senha da conta de
 
 :warning: Quando você digita sua senha, nada aparecerá na tela, **isso é normal**. Este é um recurso de segurança para mascarar não apenas sua senha como um todo, mas também seu comprimento. Basta digitar sua senha e quando terminar, pressione `Enter`.
 
-:warning: Se você vir este aviso :point_down:, execute os dois comandos na seção `Próximas etapas` para adicionar o Homebrew ao seu PATH:
+Se você já tem o Homebrew, ele lhe dirá, tudo bem, vá em frente.
 
-![Aviso de instalação do macOS Homebrew](images/macos_homebrew_warning.png)
+Quando a instalação do Homebrew terminar, execute estes dois comandos para adicioná-lo ao seu `PATH`:
 
 ```bash
-# ⚠️ Execute esses comandos apenas se você viu este aviso ☝
 echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
 eval "$(/opt/homebrew/bin/brew shellenv)"
 ```
 
-Se você já tem o Homebrew, ele lhe dirá, tudo bem, vá em frente.
-
 Em seguida, instale algum software útil:
 
 ```bash
 brew update
 ```
 
-Se você receber um erro `/usr/local deve ser gravável`, basta executar isto:
-
-```bash
-sudo chown -R $USER:admin /usr/local
-```
-
-```bash
-brew update
-```
-
 Continue executando o seguinte no terminal (você pode copiar/colar todas as linhas de uma vez):
 
 ```bash

From 204c8cd36c46de8d7c7da74e70ef25594275ed2d Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 17 Sep 2026 18:01:21 +0000
Subject: [PATCH 02/16] setup guides generated

---
 macos.cn.md | 14 +++-----------
 macos.es.md | 14 ++------------
 macos.fr.md | 14 ++------------
 macos.md    | 17 ++---------------
 macos.pt.md | 17 ++---------------
 5 files changed, 11 insertions(+), 65 deletions(-)

diff --git a/macos.cn.md b/macos.cn.md
index 9f5a06b2..bd9aaea5 100644
--- a/macos.cn.md
+++ b/macos.cn.md
@@ -71,17 +71,16 @@ sudo softwareupdate --clear-catalog
 
 :warning: 当你输入你的密码的时候，屏幕上不会有任何的显示，**这是正常的**。这是一个安全保护的设置，来隐藏你整个密码，包括它的长度。你可以放心的输入你的密码，结束后按下`Enter`就可以了。
 
-:warning: 如果你看到了下面的警告:point_down:，运行`Next steps`下面的两个命令把Homebrew加到你的PATH里。
+如果你已经有了Homebrew,终端会告诉你的。那么一切正常，你可以继续接下来的步骤。
+
+Homebrew安装完成后，运行以下两个命令，将其添加到你的`PATH`中：
 
-![macOS Homebrew installation warning](images/macos_homebrew_warning.png)
 
 ```bash
-# ⚠️ Only execute these commands if you saw this warning ☝
 echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
 eval "$(/opt/homebrew/bin/brew shellenv)"
 ```
 
-如果你已经有了Homebrew,终端会告诉你的。那么一切正常，你可以继续接下来的步骤。
 
 接下来，让我们安装一些有用的软件：
 
@@ -89,13 +88,6 @@ eval "$(/opt/homebrew/bin/brew shellenv)"
 brew update
 ```
 
-如果你得到了`/usr/local must be writable`的报错，直接运行以下指令：
-
-```bash
-sudo chown -R $USER:admin /usr/local
-brew update
-```
-
 无论是否有这行报错，继续执行下方的指令（你可以一次性直接复制/粘贴下方所有行）
 
 ```bash
diff --git a/macos.es.md b/macos.es.md
index 37e7fb2c..eb1273a7 100644
--- a/macos.es.md
+++ b/macos.es.md
@@ -72,31 +72,21 @@ Te pedirá que confirmes (presionando `Enter`) y también te pedirá la **contra
 
 :warning: Cuando escribas tu contraseña no verás nada en la pantalla. **Esto es normal**. Es una herramienta de seguridad para ocultar tanto el contenido de tu contraseña como su longitud. Simplemente escribe tu contraseña y presiona `Enter` al terminar.
 
-:warning: Si ves esta advertencia :point_down:, ejecuta los dos comandos de la sección `Next steps` para añadir Homebrew a tu PATH:
+Si ya tienes Homebrew instalado, el sistema te lo dirá y puedes continuar.
 
-![macOS Homebrew installation warning](images/macos_homebrew_warning.png)
+Una vez que Homebrew haya terminado de instalarse, ejecuta estos dos comandos para agregarlo a tu `PATH`:
 
 ```bash
-# ⚠️ Only execute these commands if you saw this warning ☝
 echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
 eval "$(/opt/homebrew/bin/brew shellenv)"
 ```
 
-Si ya tienes Homebrew instalado, el sistema te lo dirá y puedes continuar.
-
 Luego instala algunos programas útiles:
 
 ```bash
 brew update
 ```
 
-Si obtienes un error como este: `/usr/local must be writable`, ejecuta el código que te mostramos a continuación:
-
-```bash
-sudo chown -R $USER:admin /usr/local
-brew update
-```
-
 Ejecuta el siguiente código en tu terminal (puedes copiar y pegar todas las líneas de código al mismo tiempo):
 
 ```bash
diff --git a/macos.fr.md b/macos.fr.md
index 3cb094f7..93fbe4f6 100644
--- a/macos.fr.md
+++ b/macos.fr.md
@@ -71,31 +71,21 @@ On te demandera de confirmer (appuie sur `Enter`) et de saisir ton **mot de pass
 
 :warning: Lorsque tu saisiras ton mot de passe, rien ne s’affichera à l’écran ; **c’est normal**. Il s’agit d’une mesure de sécurité permettant de masquer ton mot de passe et sa longueur. Saisis simplement ton mot de passe, puis appuie sur `Enter`.
 
-:warning: Si tu vois cet avertissement :point_down:, exécute les deux commandes de la section `Next steps` pour ajouter Homebrew à ton PATH
+Si tu as déjà Homebrew, le système te l’indiquera. Continue.
 
-![macOS Homebrew installation warning](images/macos_homebrew_warning.png)
+Une fois l’installation de Homebrew terminée, exécute les deux commandes suivantes pour l’ajouter à ton `PATH` :
 
 ```bash
-# ⚠️ Only execute these commands if you saw this warning ☝
 echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
 eval "$(/opt/homebrew/bin/brew shellenv)"
 ```
 
-Si tu as déjà Homebrew, le système te l’indiquera. Continue.
-
 Installe ensuite quelques logiciels utiles :
 
 ```bash
 brew update
 ```
 
-Si tu vois apparaître une erreur `/usr/local must be writable`, exécute simplement :
-
-```bash
-sudo chown -R $USER:admin /usr/local
-brew update
-```
-
 Exécute les commandes suivantes dans le terminal (tu peux copier-coller toutes les lignes en une seule fois):
 
 ```bash
diff --git a/macos.md b/macos.md
index 8f603b83..b2345589 100644
--- a/macos.md
+++ b/macos.md
@@ -77,34 +77,21 @@ This will ask for your confirmation (hit `Enter`) and your **macOS user account
 
 :warning: When you type your password, nothing will show up on the screen, **that's normal**. This is a security feature to mask not only your password as a whole but also its length. Just type your password and when you're done, press `Enter`.
 
-:warning: If you see this warning :point_down:, run the two commands in the `Next steps` section to add Homebrew to your PATH:
+If you already have Homebrew, it will tell you so, that's fine, go on.
 
-![macOS Homebrew installation warning](images/macos_homebrew_warning.png)
+Once Homebrew has finished installing, run these two commands to add it to your `PATH`:
 
 ```bash
-# ⚠️ Only execute these commands if you saw this warning ☝
 echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
 eval "$(/opt/homebrew/bin/brew shellenv)"
 ```
 
-If you already have Homebrew, it will tell you so, that's fine, go on.
-
 Then install some useful software:
 
 ```bash
 brew update
 ```
 
-If you get a `/usr/local must be writable` error, just run this:
-
-```bash
-sudo chown -R $USER:admin /usr/local
-```
-
-```bash
-brew update
-```
-
 Proceed running the following in the terminal (you can copy / paste all the lines at once):
 
 ```bash
diff --git a/macos.pt.md b/macos.pt.md
index 877d6523..bdddcb72 100644
--- a/macos.pt.md
+++ b/macos.pt.md
@@ -76,34 +76,21 @@ Isso solicitará sua confirmação (pressione `Enter`) e sua **senha da conta de
 
 :warning: Quando você digita sua senha, nada aparecerá na tela, **isso é normal**. Este é um recurso de segurança para mascarar não apenas sua senha como um todo, mas também seu comprimento. Basta digitar sua senha e quando terminar, pressione `Enter`.
 
-:warning: Se você vir este aviso :point_down:, execute os dois comandos na seção `Próximas etapas` para adicionar o Homebrew ao seu PATH:
+Se você já tem o Homebrew, ele lhe dirá, tudo bem, vá em frente.
 
-![Aviso de instalação do macOS Homebrew](images/macos_homebrew_warning.png)
+Quando a instalação do Homebrew terminar, execute estes dois comandos para adicioná-lo ao seu `PATH`:
 
 ```bash
-# ⚠️ Execute esses comandos apenas se você viu este aviso ☝
 echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
 eval "$(/opt/homebrew/bin/brew shellenv)"
 ```
 
-Se você já tem o Homebrew, ele lhe dirá, tudo bem, vá em frente.
-
 Em seguida, instale algum software útil:
 
 ```bash
 brew update
 ```
 
-Se você receber um erro `/usr/local deve ser gravável`, basta executar isto:
-
-```bash
-sudo chown -R $USER:admin /usr/local
-```
-
-```bash
-brew update
-```
-
 Continue executando o seguinte no terminal (você pode copiar/colar todas as linhas de uma vez):
 
 ```bash

From 63d9875ad2cf96f9009c5b16e40bad4227c932a2 Mon Sep 17 00:00:00 2001
From: Jules van Rie <jules@vanrie.be>
Date: Thu, 17 Sep 2026 20:13:53 +0200
Subject: [PATCH 03/16] Align explanation with what we do

---
 _partials/cn/macos_homebrew.md | 4 ++--
 _partials/es/macos_homebrew.md | 4 ++--
 _partials/fr/macos_homebrew.md | 4 ++--
 _partials/macos_homebrew.md    | 4 ++--
 _partials/pt/macos_homebrew.md | 4 ++--
 5 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/_partials/cn/macos_homebrew.md b/_partials/cn/macos_homebrew.md
index 9f88ed4a..6093bc22 100644
--- a/_partials/cn/macos_homebrew.md
+++ b/_partials/cn/macos_homebrew.md
@@ -23,13 +23,13 @@ eval "$(/opt/homebrew/bin/brew shellenv)"
 ```
 
 
-接下来，让我们安装一些有用的软件：
+确保你使用的是最新版本：
 
 ```bash
 brew update
 ```
 
-无论是否有这行报错，继续执行下方的指令（你可以一次性直接复制/粘贴下方所有行）
+然后安装一些有用的软件（你可以一次性复制/粘贴下面的所有命令）：
 
 ```bash
 brew upgrade git         || brew install git
diff --git a/_partials/es/macos_homebrew.md b/_partials/es/macos_homebrew.md
index f4a4e35c..8e81ea7d 100644
--- a/_partials/es/macos_homebrew.md
+++ b/_partials/es/macos_homebrew.md
@@ -21,13 +21,13 @@ echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
 eval "$(/opt/homebrew/bin/brew shellenv)"
 ```
 
-Luego instala algunos programas útiles:
+Asegúrate de tener la última versión:
 
 ```bash
 brew update
 ```
 
-Ejecuta el siguiente código en tu terminal (puedes copiar y pegar todas las líneas de código al mismo tiempo):
+Luego, instala algunos programas útiles (puedes copiar y pegar todas las líneas de código al mismo tiempo):
 
 ```bash
 brew upgrade git || brew install git
diff --git a/_partials/fr/macos_homebrew.md b/_partials/fr/macos_homebrew.md
index 209cda03..c52ea67f 100644
--- a/_partials/fr/macos_homebrew.md
+++ b/_partials/fr/macos_homebrew.md
@@ -21,13 +21,13 @@ echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
 eval "$(/opt/homebrew/bin/brew shellenv)"
 ```
 
-Installe ensuite quelques logiciels utiles :
+Assure-toi d’avoir la dernière version :
 
 ```bash
 brew update
 ```
 
-Exécute les commandes suivantes dans le terminal (tu peux copier-coller toutes les lignes en une seule fois):
+Installe ensuite quelques logiciels utiles (tu peux copier / coller toutes les lignes en une seule fois) :
 
 ```bash
 brew upgrade git         || brew install git
diff --git a/_partials/macos_homebrew.md b/_partials/macos_homebrew.md
index cfcf1235..53156a15 100644
--- a/_partials/macos_homebrew.md
+++ b/_partials/macos_homebrew.md
@@ -21,13 +21,13 @@ echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
 eval "$(/opt/homebrew/bin/brew shellenv)"
 ```
 
-Then install some useful software:
+Make sure you're on the latest version:
 
 ```bash
 brew update
 ```
 
-Proceed running the following in the terminal (you can copy / paste all the lines at once):
+Then install some useful software (you can copy / paste all the lines at once):
 
 ```bash
 brew upgrade git         || brew install git
diff --git a/_partials/pt/macos_homebrew.md b/_partials/pt/macos_homebrew.md
index 20198cc0..636e0bf8 100644
--- a/_partials/pt/macos_homebrew.md
+++ b/_partials/pt/macos_homebrew.md
@@ -21,13 +21,13 @@ echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
 eval "$(/opt/homebrew/bin/brew shellenv)"
 ```
 
-Em seguida, instale algum software útil:
+Certifique-se de que está usando a versão mais recente:
 
 ```bash
 brew update
 ```
 
-Continue executando o seguinte no terminal (você pode copiar/colar todas as linhas de uma vez):
+Em seguida, instale alguns softwares úteis (você pode copiar/colar todas as linhas de uma vez):
 
 ```bash
 brew upgrade git         || brew install git

From 66a703e63dc65a8a1c2bcc9fc188afc04d84124f Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 17 Sep 2026 18:14:07 +0000
Subject: [PATCH 04/16] setup guides generated

---
 macos.cn.md | 4 ++--
 macos.es.md | 4 ++--
 macos.fr.md | 4 ++--
 macos.md    | 4 ++--
 macos.pt.md | 4 ++--
 5 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/macos.cn.md b/macos.cn.md
index bd9aaea5..d0a387d6 100644
--- a/macos.cn.md
+++ b/macos.cn.md
@@ -82,13 +82,13 @@ eval "$(/opt/homebrew/bin/brew shellenv)"
 ```
 
 
-接下来，让我们安装一些有用的软件：
+确保你使用的是最新版本：
 
 ```bash
 brew update
 ```
 
-无论是否有这行报错，继续执行下方的指令（你可以一次性直接复制/粘贴下方所有行）
+然后安装一些有用的软件（你可以一次性复制/粘贴下面的所有命令）：
 
 ```bash
 brew upgrade git         || brew install git
diff --git a/macos.es.md b/macos.es.md
index eb1273a7..28785e26 100644
--- a/macos.es.md
+++ b/macos.es.md
@@ -81,13 +81,13 @@ echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
 eval "$(/opt/homebrew/bin/brew shellenv)"
 ```
 
-Luego instala algunos programas útiles:
+Asegúrate de tener la última versión:
 
 ```bash
 brew update
 ```
 
-Ejecuta el siguiente código en tu terminal (puedes copiar y pegar todas las líneas de código al mismo tiempo):
+Luego, instala algunos programas útiles (puedes copiar y pegar todas las líneas de código al mismo tiempo):
 
 ```bash
 brew upgrade git || brew install git
diff --git a/macos.fr.md b/macos.fr.md
index 93fbe4f6..940bc492 100644
--- a/macos.fr.md
+++ b/macos.fr.md
@@ -80,13 +80,13 @@ echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
 eval "$(/opt/homebrew/bin/brew shellenv)"
 ```
 
-Installe ensuite quelques logiciels utiles :
+Assure-toi d’avoir la dernière version :
 
 ```bash
 brew update
 ```
 
-Exécute les commandes suivantes dans le terminal (tu peux copier-coller toutes les lignes en une seule fois):
+Installe ensuite quelques logiciels utiles (tu peux copier / coller toutes les lignes en une seule fois) :
 
 ```bash
 brew upgrade git         || brew install git
diff --git a/macos.md b/macos.md
index b2345589..18f1e01f 100644
--- a/macos.md
+++ b/macos.md
@@ -86,13 +86,13 @@ echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
 eval "$(/opt/homebrew/bin/brew shellenv)"
 ```
 
-Then install some useful software:
+Make sure you're on the latest version:
 
 ```bash
 brew update
 ```
 
-Proceed running the following in the terminal (you can copy / paste all the lines at once):
+Then install some useful software (you can copy / paste all the lines at once):
 
 ```bash
 brew upgrade git         || brew install git
diff --git a/macos.pt.md b/macos.pt.md
index bdddcb72..13a03b32 100644
--- a/macos.pt.md
+++ b/macos.pt.md
@@ -85,13 +85,13 @@ echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
 eval "$(/opt/homebrew/bin/brew shellenv)"
 ```
 
-Em seguida, instale algum software útil:
+Certifique-se de que está usando a versão mais recente:
 
 ```bash
 brew update
 ```
 
-Continue executando o seguinte no terminal (você pode copiar/colar todas as linhas de uma vez):
+Em seguida, instale alguns softwares úteis (você pode copiar/colar todas as linhas de uma vez):
 
 ```bash
 brew upgrade git         || brew install git

From e4518f8601d1c657740a32a8aa1907b17609d94d Mon Sep 17 00:00:00 2001
From: Jules van Rie <jules@vanrie.be>
Date: Thu, 17 Sep 2026 20:18:31 +0200
Subject: [PATCH 05/16] Add tree as useful util

---
 _partials/cn/macos_homebrew.md | 1 +
 _partials/es/macos_homebrew.md | 1 +
 _partials/fr/macos_homebrew.md | 2 ++
 _partials/macos_homebrew.md    | 1 +
 _partials/pt/macos_homebrew.md | 1 +
 5 files changed, 6 insertions(+)

diff --git a/_partials/cn/macos_homebrew.md b/_partials/cn/macos_homebrew.md
index 6093bc22..0262f6b8 100644
--- a/_partials/cn/macos_homebrew.md
+++ b/_partials/cn/macos_homebrew.md
@@ -38,4 +38,5 @@ brew upgrade wget        || brew install wget
 brew upgrade imagemagick || brew install imagemagick
 brew upgrade jq          || brew install jq
 brew upgrade openssl     || brew install openssl
+brew upgrade tree        || brew install tree
 ```
diff --git a/_partials/es/macos_homebrew.md b/_partials/es/macos_homebrew.md
index 8e81ea7d..138635d3 100644
--- a/_partials/es/macos_homebrew.md
+++ b/_partials/es/macos_homebrew.md
@@ -36,4 +36,5 @@ brew upgrade wget || brew install wget
 brew upgrade imagemagick || brew install imagemagick
 brew upgrade jq || brew install jq
 brew upgrade openssl || brew install openssl
+brew upgrade tree        || brew install tree
 ```
diff --git a/_partials/fr/macos_homebrew.md b/_partials/fr/macos_homebrew.md
index c52ea67f..dd9e2e35 100644
--- a/_partials/fr/macos_homebrew.md
+++ b/_partials/fr/macos_homebrew.md
@@ -36,4 +36,6 @@ brew upgrade wget        || brew install wget
 brew upgrade imagemagick || brew install imagemagick
 brew upgrade jq          || brew install jq
 brew upgrade openssl     || brew install openssl
+brew upgrade tree        || brew install tree
+brew upgrade tree        || brew install tree
 ```
diff --git a/_partials/macos_homebrew.md b/_partials/macos_homebrew.md
index 53156a15..f32af248 100644
--- a/_partials/macos_homebrew.md
+++ b/_partials/macos_homebrew.md
@@ -36,4 +36,5 @@ brew upgrade wget        || brew install wget
 brew upgrade imagemagick || brew install imagemagick
 brew upgrade jq          || brew install jq
 brew upgrade openssl     || brew install openssl
+brew upgrade tree        || brew install tree
 ```
diff --git a/_partials/pt/macos_homebrew.md b/_partials/pt/macos_homebrew.md
index 636e0bf8..d537e534 100644
--- a/_partials/pt/macos_homebrew.md
+++ b/_partials/pt/macos_homebrew.md
@@ -36,4 +36,5 @@ brew upgrade wget        || brew install wget
 brew upgrade imagemagick || brew install imagemagick
 brew upgrade jq          || brew install jq
 brew upgrade openssl     || brew install openssl
+brew upgrade tree        || brew install tree
 ```

From 90be837bb941670b67262fd8a2abf7c81acd681f Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 17 Sep 2026 18:18:46 +0000
Subject: [PATCH 06/16] setup guides generated

---
 macos.cn.md | 1 +
 macos.es.md | 1 +
 macos.fr.md | 2 ++
 macos.md    | 1 +
 macos.pt.md | 1 +
 5 files changed, 6 insertions(+)

diff --git a/macos.cn.md b/macos.cn.md
index d0a387d6..345cf427 100644
--- a/macos.cn.md
+++ b/macos.cn.md
@@ -97,6 +97,7 @@ brew upgrade wget        || brew install wget
 brew upgrade imagemagick || brew install imagemagick
 brew upgrade jq          || brew install jq
 brew upgrade openssl     || brew install openssl
+brew upgrade tree        || brew install tree
 ```
 
 
diff --git a/macos.es.md b/macos.es.md
index 28785e26..ee62977a 100644
--- a/macos.es.md
+++ b/macos.es.md
@@ -96,6 +96,7 @@ brew upgrade wget || brew install wget
 brew upgrade imagemagick || brew install imagemagick
 brew upgrade jq || brew install jq
 brew upgrade openssl || brew install openssl
+brew upgrade tree        || brew install tree
 ```
 
 
diff --git a/macos.fr.md b/macos.fr.md
index 940bc492..078cd22c 100644
--- a/macos.fr.md
+++ b/macos.fr.md
@@ -95,6 +95,8 @@ brew upgrade wget        || brew install wget
 brew upgrade imagemagick || brew install imagemagick
 brew upgrade jq          || brew install jq
 brew upgrade openssl     || brew install openssl
+brew upgrade tree        || brew install tree
+brew upgrade tree        || brew install tree
 ```
 
 
diff --git a/macos.md b/macos.md
index 18f1e01f..f6e2e5ff 100644
--- a/macos.md
+++ b/macos.md
@@ -101,6 +101,7 @@ brew upgrade wget        || brew install wget
 brew upgrade imagemagick || brew install imagemagick
 brew upgrade jq          || brew install jq
 brew upgrade openssl     || brew install openssl
+brew upgrade tree        || brew install tree
 ```
 
 
diff --git a/macos.pt.md b/macos.pt.md
index 13a03b32..1ac38b6a 100644
--- a/macos.pt.md
+++ b/macos.pt.md
@@ -100,6 +100,7 @@ brew upgrade wget        || brew install wget
 brew upgrade imagemagick || brew install imagemagick
 brew upgrade jq          || brew install jq
 brew upgrade openssl     || brew install openssl
+brew upgrade tree        || brew install tree
 ```
 
 

From e0449a698ac72ed3ecbcc6c473476e42209d6445 Mon Sep 17 00:00:00 2001
From: Jules van Rie <jules@vanrie.be>
Date: Thu, 17 Sep 2026 20:20:02 +0200
Subject: [PATCH 07/16] Remove duplicate in FR version

---
 _partials/fr/macos_homebrew.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/_partials/fr/macos_homebrew.md b/_partials/fr/macos_homebrew.md
index dd9e2e35..5aac3d36 100644
--- a/_partials/fr/macos_homebrew.md
+++ b/_partials/fr/macos_homebrew.md
@@ -37,5 +37,4 @@ brew upgrade imagemagick || brew install imagemagick
 brew upgrade jq          || brew install jq
 brew upgrade openssl     || brew install openssl
 brew upgrade tree        || brew install tree
-brew upgrade tree        || brew install tree
 ```

From d78fb436222d571521df84aa92ba261235a3ed4b Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 17 Sep 2026 18:20:16 +0000
Subject: [PATCH 08/16] setup guides generated

---
 macos.fr.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/macos.fr.md b/macos.fr.md
index 078cd22c..aa3234ca 100644
--- a/macos.fr.md
+++ b/macos.fr.md
@@ -96,7 +96,6 @@ brew upgrade imagemagick || brew install imagemagick
 brew upgrade jq          || brew install jq
 brew upgrade openssl     || brew install openssl
 brew upgrade tree        || brew install tree
-brew upgrade tree        || brew install tree
 ```
 
 

From 8b19d93291e7305779fa7c09682d08afff63d109 Mon Sep 17 00:00:00 2001
From: Jules van Rie <jules@vanrie.be>
Date: Thu, 17 Sep 2026 20:22:56 +0200
Subject: [PATCH 09/16] Align Spanish like others

---
 _partials/es/macos_homebrew.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/_partials/es/macos_homebrew.md b/_partials/es/macos_homebrew.md
index 138635d3..1ad6113b 100644
--- a/_partials/es/macos_homebrew.md
+++ b/_partials/es/macos_homebrew.md
@@ -30,11 +30,11 @@ brew update
 Luego, instala algunos programas útiles (puedes copiar y pegar todas las líneas de código al mismo tiempo):
 
 ```bash
-brew upgrade git || brew install git
-brew upgrade gh || brew install gh
-brew upgrade wget || brew install wget
+brew upgrade git         || brew install git
+brew upgrade gh          || brew install gh
+brew upgrade wget        || brew install wget
 brew upgrade imagemagick || brew install imagemagick
-brew upgrade jq || brew install jq
-brew upgrade openssl || brew install openssl
+brew upgrade jq          || brew install jq
+brew upgrade openssl     || brew install openssl
 brew upgrade tree        || brew install tree
 ```

From a2eaf98f578aaeef430f8ad3f2f6adb9f3d86c51 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 17 Sep 2026 18:23:13 +0000
Subject: [PATCH 10/16] setup guides generated

---
 macos.es.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/macos.es.md b/macos.es.md
index ee62977a..b5c43503 100644
--- a/macos.es.md
+++ b/macos.es.md
@@ -90,12 +90,12 @@ brew update
 Luego, instala algunos programas útiles (puedes copiar y pegar todas las líneas de código al mismo tiempo):
 
 ```bash
-brew upgrade git || brew install git
-brew upgrade gh || brew install gh
-brew upgrade wget || brew install wget
+brew upgrade git         || brew install git
+brew upgrade gh          || brew install gh
+brew upgrade wget        || brew install wget
 brew upgrade imagemagick || brew install imagemagick
-brew upgrade jq || brew install jq
-brew upgrade openssl || brew install openssl
+brew upgrade jq          || brew install jq
+brew upgrade openssl     || brew install openssl
 brew upgrade tree        || brew install tree
 ```
 

From 986c5fadcb55388dba181fd53c9cd4e8278432ee Mon Sep 17 00:00:00 2001
From: Jules van Rie <jules@vanrie.be>
Date: Fri, 18 Sep 2026 00:44:49 +0200
Subject: [PATCH 11/16] Drop outdated checks for WSL1

---
 _partials/windows_ubuntu.md | 51 -------------------------------------
 1 file changed, 51 deletions(-)

diff --git a/_partials/windows_ubuntu.md b/_partials/windows_ubuntu.md
index 5d5326a2..2dcbb77e 100644
--- a/_partials/windows_ubuntu.md
+++ b/_partials/windows_ubuntu.md
@@ -49,57 +49,6 @@ At first launch, you will be asked some information:
 
 :warning: When you type your password, nothing will show up on the screen, **that's normal**. This is a security feature to mask not only your password as a whole but also its length. Just type your password and when you're done, press `Enter`.
 
-
-### Check the WSL version of Ubuntu
-
-- Press `Windows` + `R`
-- Type  `cmd`
-- Press `Enter`
-
-Type the following command:
-
-```bash
-wsl -l -v
-```
-
-:heavy_check_mark: If the version of Ubuntu WSL is 2, you are good to go :+1:
-
-:x: If the version of Ubuntu WSL is 1, we will need to convert it to version 2.
-
-<details>
-  <summary>Convert Ubuntu WSL V1 to V2</summary>
-
-  In the Command Prompt window, type:
-
-  ```bash
-  wsl --set-version Ubuntu 2
-  ```
-
-  :heavy_check_mark: After a few seconds, you should get the following message: `The conversion is complete`.
-
-  :x: If it does not work, we need to be sure that Ubuntu files are not compressed.
-
-<details>
-  <summary>Check for Uncompressed Files</summary>
-
-  - Press `Windows` + `R`
-  - Type  `%localappdata%\Packages`
-  - Press `Enter`
-  - Open the folder named `CanonicalGroupLimited.UbuntuonWindows...`
-  - Right Click on the `LocalState` folder
-  - Click on `Properties`
-  - Click on `Advanced`
-  - Make sure that the option `Compress content` is **not** ticked, then click on `Ok`.
-
-  Apply changes to this folder only and try to convert the Ubuntu WSL version again.
-
-  :x: If the conversion still does not work, please **contact a teacher**.
-</details>
-
-You can close this terminal now.
-
-</details>
-
 ### Check your username
 
 Type this in the Ubuntu terminal:

From b71a1acd2a64158ff6ffd73f1cce5129ed20ce76 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 17 Sep 2026 22:45:19 +0000
Subject: [PATCH 12/16] setup guides generated

---
 windows.md | 51 ---------------------------------------------------
 1 file changed, 51 deletions(-)

diff --git a/windows.md b/windows.md
index 9b01088a..f119481e 100644
--- a/windows.md
+++ b/windows.md
@@ -296,57 +296,6 @@ At first launch, you will be asked some information:
 
 :warning: When you type your password, nothing will show up on the screen, **that's normal**. This is a security feature to mask not only your password as a whole but also its length. Just type your password and when you're done, press `Enter`.
 
-
-### Check the WSL version of Ubuntu
-
-- Press `Windows` + `R`
-- Type  `cmd`
-- Press `Enter`
-
-Type the following command:
-
-```bash
-wsl -l -v
-```
-
-:heavy_check_mark: If the version of Ubuntu WSL is 2, you are good to go :+1:
-
-:x: If the version of Ubuntu WSL is 1, we will need to convert it to version 2.
-
-<details>
-  <summary>Convert Ubuntu WSL V1 to V2</summary>
-
-  In the Command Prompt window, type:
-
-  ```bash
-  wsl --set-version Ubuntu 2
-  ```
-
-  :heavy_check_mark: After a few seconds, you should get the following message: `The conversion is complete`.
-
-  :x: If it does not work, we need to be sure that Ubuntu files are not compressed.
-
-<details>
-  <summary>Check for Uncompressed Files</summary>
-
-  - Press `Windows` + `R`
-  - Type  `%localappdata%\Packages`
-  - Press `Enter`
-  - Open the folder named `CanonicalGroupLimited.UbuntuonWindows...`
-  - Right Click on the `LocalState` folder
-  - Click on `Properties`
-  - Click on `Advanced`
-  - Make sure that the option `Compress content` is **not** ticked, then click on `Ok`.
-
-  Apply changes to this folder only and try to convert the Ubuntu WSL version again.
-
-  :x: If the conversion still does not work, please **contact a teacher**.
-</details>
-
-You can close this terminal now.
-
-</details>
-
 ### Check your username
 
 Type this in the Ubuntu terminal:

From f25ada2578ea4bae0ade39b2d2018981b76f9655 Mon Sep 17 00:00:00 2001
From: Jules van Rie <jules@vanrie.be>
Date: Fri, 18 Sep 2026 13:16:35 +0200
Subject: [PATCH 13/16] Add instructions where to find the terminal

---
 _partials/macos_command_line_tools.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/_partials/macos_command_line_tools.md b/_partials/macos_command_line_tools.md
index e7698d61..3bb6c293 100644
--- a/_partials/macos_command_line_tools.md
+++ b/_partials/macos_command_line_tools.md
@@ -8,7 +8,11 @@ During this setup you will be asked to **quit and re-open** applications multipl
 
 ## Command Line Tools
 
-Open a new terminal, copy-paste the following command and hit `Enter`:
+Open a new terminal window from Launchpad > Other, or from Finder > Applications > Utilities, or search for it with [Spotlight](https://support.apple.com/en-gb/HT204014):
+
+![Open Terminal on macOS](images/macos_open_terminal.png)
+
+Copy-paste the following command and hit `Enter`:
 
 ```bash
 xcode-select --install

From 3a5b2eb2af4a9f6e186642daec697b1d3591ee06 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 18 Sep 2026 11:17:01 +0000
Subject: [PATCH 14/16] setup guides generated

---
 macos.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/macos.md b/macos.md
index 8f603b83..b2115786 100644
--- a/macos.md
+++ b/macos.md
@@ -33,7 +33,11 @@ During this setup you will be asked to **quit and re-open** applications multipl
 
 ## Command Line Tools
 
-Open a new terminal, copy-paste the following command and hit `Enter`:
+Open a new terminal window from Launchpad > Other, or from Finder > Applications > Utilities, or search for it with [Spotlight](https://support.apple.com/en-gb/HT204014):
+
+![Open Terminal on macOS](images/macos_open_terminal.png)
+
+Copy-paste the following command and hit `Enter`:
 
 ```bash
 xcode-select --install

From a05243a5c152e2347eef9ed61d62f577bfd9e04f Mon Sep 17 00:00:00 2001
From: Jules van Rie <jules@vanrie.be>
Date: Fri, 18 Sep 2026 13:55:14 +0200
Subject: [PATCH 15/16] Auto confirm brew

---
 _partials/macos_homebrew.md | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/_partials/macos_homebrew.md b/_partials/macos_homebrew.md
index f32af248..fade2216 100644
--- a/_partials/macos_homebrew.md
+++ b/_partials/macos_homebrew.md
@@ -30,11 +30,11 @@ brew update
 Then install some useful software (you can copy / paste all the lines at once):
 
 ```bash
-brew upgrade git         || brew install git
-brew upgrade gh          || brew install gh
-brew upgrade wget        || brew install wget
-brew upgrade imagemagick || brew install imagemagick
-brew upgrade jq          || brew install jq
-brew upgrade openssl     || brew install openssl
-brew upgrade tree        || brew install tree
+brew upgrade git         || brew install -y git
+brew upgrade gh          || brew install -y gh
+brew upgrade wget        || brew install -y wget
+brew upgrade imagemagick || brew install -y imagemagick
+brew upgrade jq          || brew install -y jq
+brew upgrade openssl     || brew install -y openssl
+brew upgrade tree        || brew install -y tree
 ```

From 384a0550180ff513010ed449ba5aee7759b76721 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 18 Sep 2026 11:55:31 +0000
Subject: [PATCH 16/16] setup guides generated

---
 macos.md | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/macos.md b/macos.md
index f6e2e5ff..c7bfadf1 100644
--- a/macos.md
+++ b/macos.md
@@ -95,13 +95,13 @@ brew update
 Then install some useful software (you can copy / paste all the lines at once):
 
 ```bash
-brew upgrade git         || brew install git
-brew upgrade gh          || brew install gh
-brew upgrade wget        || brew install wget
-brew upgrade imagemagick || brew install imagemagick
-brew upgrade jq          || brew install jq
-brew upgrade openssl     || brew install openssl
-brew upgrade tree        || brew install tree
+brew upgrade git         || brew install -y git
+brew upgrade gh          || brew install -y gh
+brew upgrade wget        || brew install -y wget
+brew upgrade imagemagick || brew install -y imagemagick
+brew upgrade jq          || brew install -y jq
+brew upgrade openssl     || brew install -y openssl
+brew upgrade tree        || brew install -y tree
 ```