From f355d2fe1a9181e34d50dc35a01fb5d01523d855 Mon Sep 17 00:00:00 2001
From: Mike Szczys <mike@golioth.io>
Date: Wed, 4 Dec 2024 12:51:07 -0600
Subject: [PATCH] zephyr: improve the download instructions

Use a code block for the `west download` command instead of inline code. Add
bullet points and better indentation for the VScode download step.

Signed-off-by: Mike Szczys <mike@golioth.io>
---
 .../_partials/download-from-codespaces.md     | 52 +++++++++++--------
 1 file changed, 30 insertions(+), 22 deletions(-)

diff --git a/website/docs/_partials/download-from-codespaces.md b/website/docs/_partials/download-from-codespaces.md
index 0fc6d0f..2ee8046 100644
--- a/website/docs/_partials/download-from-codespaces.md
+++ b/website/docs/_partials/download-from-codespaces.md
@@ -6,33 +6,41 @@ because the Codespaces container doesn't have access to your local USB port.
 
 :::
 
-* In the VS Code terminal, run `west download` to package the compiled code and
-  make it available for download
+1. In the VS Code terminal, use the following command to package the compiled
+   code and make it available for download:
 
-* Unfold the Download folder in VS Codes file explorer. Right-click on the
-  `<devicename>_<appfolder>_<hhmmss>.hex` firmware file you just build and
-  select "Download..." to download it to your local machine.
+    ```
+    west download
+    ```
 
-<details>
-  <summary>Show me how to download from Codespaces</summary>
+2. Download the binary from Codespaces
 
-![How to download binaries from Codespaces](./assets/codespaces_download_binary.png)
+    - Unfold the Download folder in VS Codes file explorer.
+    - Right-click on the `<devicename>_<appfolder>_<hhmmss>.hex` firmware file
+      you just built.
+    - select "Download..." to download it to your local machine.
 
-Because Codespaces is a virtual machine running in the cloud, we cannot directly
-program the device connected to your local machine. Instead, we will download
-the binary so that your local machine can program that file to the device in the
-next step.
+    <br />
+    <details>
+    <summary>Show me how to download from Codespaces</summary>
 
-When we ran the `west download` command it renamed the binary using the
-filename, device name, folder name of the app you built, and a timestamp. It
-moved the file to the `/zephyr-training/Downloads` folder. You can view your
-files in the VS Code file explorer, filenames should be similar to:
-`nrf9160dk_04_blinkRTOS_223209.hex`.
+    ![How to download binaries from Codespaces](./assets/codespaces_download_binary.png)
 
-The image above shows the file explorer in the left sidebar menu of VS Code.
-(The file explorer may be opened by clicking `≡`→`View`→`Explorer`).
+    Because Codespaces is a virtual machine running in the cloud, we cannot directly
+    program the device connected to your local machine. Instead, we will download
+    the binary so that your local machine can program that file to the device in the
+    next step.
 
-Right-click on the filename you want to download and select "Download..." from
-the resulting menu.
+    When we ran the `west download` command it renamed the binary using the
+    filename, device name, folder name of the app you built, and a timestamp. It
+    moved the file to the `/zephyr-training/Downloads` folder. You can view your
+    files in the VS Code file explorer, filenames should be similar to:
+    `nrf9160dk_04_blinkRTOS_223209.hex`.
 
-</details>
+    The image above shows the file explorer in the left sidebar menu of VS Code.
+    (The file explorer may be opened by clicking `≡`→`View`→`Explorer`).
+
+    Right-click on the filename you want to download and select "Download..." from
+    the resulting menu.
+
+    </details>