Merge pull request #123 from D19ital/main

Update firmware.md

Author: D19ital

assets/css/custom.css

@@ -354,6 +354,11 @@ html.dark .firmware-picker__instruction {
   line-height: 1.55;
 }
 
+.firmware-picker .firmware-picker__instruction-note {
+  margin: 0.75rem 0 0;
+  line-height: 1.55;
+}
+
 @media (max-width: 640px) {
   .firmware-picker__field,
   .firmware-picker__result {

data/firmware.yaml

@@ -38,18 +38,18 @@ groups:
 
   - id: rmk-previous
     name:
-      ru: RMK — предыдущие устройства
+      ru: RMK — предыдущие беспроводные устройства
       en: RMK — previous devices
     devices:
       - id: rmk-k03-v4
-        name: "K:03 v4"
+        name: "K:03 V4 - Wireless Edition"
         files:
           - label: { ru: Левая половина, en: Left half }
             url: https://github.com/ergohaven/rmk-eh/releases/download/v0.1.1/0.1.1_k03_left.uf2
           - label: { ru: Правая половина, en: Right half }
             url: https://github.com/ergohaven/rmk-eh/releases/download/v0.1.1/0.1.1_k03_right.uf2
       - id: rmk-imperial44
-        name: Imperial44
+        name: Imperial44 v4 - Wireless Edition
         files:
           - label: { ru: Левая половина, en: Left half }
             url: https://github.com/ergohaven/rmk-eh/releases/download/v0.1.1/0.1.1_imperial44_left.uf2
@@ -63,7 +63,7 @@ groups:
           - label: { ru: Правая половина, en: Right half }
             url: https://github.com/ergohaven/rmk-eh/releases/download/v0.1.1/0.1.1_op36_right.uf2
       - id: rmk-velvet-v3
-        name: Velvet v3
+        name: Velvet v3 - Wireless Edition
         files:
           - label: { ru: Левая половина, en: Left half }
             url: https://github.com/ergohaven/rmk-eh/releases/download/v0.1.1/0.1.1_velvet_left.uf2
@@ -169,7 +169,7 @@ groups:
 
   - id: qmk-previous
     name:
-      ru: QMK — предыдущие устройства и ревизии
+      ru: QMK — предыдущие проводные устройства
       en: QMK — previous devices and revisions
     devices:
       - id: qmk-hpd-v1
@@ -244,7 +244,7 @@ groups:
       en: ZMK — previous wireless devices
     devices:
       - id: zmk-k03-v4
-        name: "K:03 v4"
+        name: "K:03 V4 - Wireless Edition"
         files:
           - label: { ru: Левая половина — стандартная раскладка, en: Left half — standard layout }
             url: https://github.com/ergohaven/ergohaven-zmk/releases/download/2026.03.16/k03_left-ergohaven-zmk.uf2
@@ -253,7 +253,7 @@ groups:
           - label: { ru: Правая половина, en: Right half }
             url: https://github.com/ergohaven/ergohaven-zmk/releases/download/2026.03.16/k03_right-ergohaven-zmk.uf2
       - id: zmk-k03-v4-qube
-        name: "K:03 v4 + Qube"
+        name: "K:03 V4 - Wireless Edition + Qube"
         files:
           - label: { ru: Левая половина, en: Left half }
             url: https://github.com/ergohaven/ergohaven-zmk/releases/download/2026.03.16/k03_left_qube-ergohaven-zmk.uf2
@@ -264,7 +264,7 @@ groups:
           - label: { ru: Qube — раскладка RuEn, en: Qube — RuEn layout }
             url: https://github.com/ergohaven/ergohaven-zmk/releases/download/2026.03.16/k03_qube_ruen-ergohaven-zmk.uf2
       - id: zmk-imperial44
-        name: Imperial44
+        name: Imperial44 v4 - Wireless Edition
         files:
           - label: { ru: Левая половина — стандартная раскладка, en: Left half — standard layout }
             url: https://github.com/ergohaven/ergohaven-zmk/releases/download/2026.03.16/imperial44_left-ergohaven-zmk.uf2
@@ -273,7 +273,7 @@ groups:
           - label: { ru: Правая половина, en: Right half }
             url: https://github.com/ergohaven/ergohaven-zmk/releases/download/2026.03.16/imperial44_right-ergohaven-zmk.uf2
       - id: zmk-imperial44-qube
-        name: Imperial44 + Qube
+        name: Imperial44 v4 - Wireless Edition + Qube
         files:
           - label: { ru: Левая половина, en: Left half }
             url: https://github.com/ergohaven/ergohaven-zmk/releases/download/2026.03.16/imperial44_left_qube-ergohaven-zmk.uf2
@@ -304,7 +304,7 @@ groups:
           - label: { ru: Qube — раскладка RuEn, en: Qube — RuEn layout }
             url: https://github.com/ergohaven/ergohaven-zmk/releases/download/2026.03.16/op36_qube_ruen-ergohaven-zmk.uf2
       - id: zmk-velvet-v3
-        name: Velvet v3
+        name: Velvet v3 - Wireless Edition
         files:
           - label: { ru: Левая половина — стандартная раскладка, en: Left half — standard layout }
             url: https://github.com/ergohaven/ergohaven-zmk/releases/download/2026.03.16/velvet_v3_left-ergohaven-zmk.uf2
@@ -313,7 +313,7 @@ groups:
           - label: { ru: Правая половина, en: Right half }
             url: https://github.com/ergohaven/ergohaven-zmk/releases/download/2026.03.16/velvet_v3_right-ergohaven-zmk.uf2
       - id: zmk-velvet-v3-qube
-        name: Velvet v3 + Qube
+        name: Velvet v3 - Wireless Edition + Qube
         files:
           - label: { ru: Левая половина, en: Left half }
             url: https://github.com/ergohaven/ergohaven-zmk/releases/download/2026.03.16/velvet_v3_left_qube-ergohaven-zmk.uf2

data/firmware_instructions.yaml

@@ -2,75 +2,87 @@ rmk_split:
   ru:
     title: Как обновить прошивку
     steps:
+      - 'При необходимости сохраните текущую раскладку в <a href="https://github.com/ergohaven/entropy" target="_blank" rel="noopener">Entropy</a>'
       - "Скачайте файлы прошивки для левой и правой половинок"
-      - "Подключите левую половинку по USB-C, дважды быстро нажмите <code>Reset</code> и скопируйте на открывшийся диск файл <code>left</code>"
+      - "Подключите левую половинку по USB-C, дважды быстро нажмите <code>Reset</code> с обратной стороны корпуса и скопируйте на появившийся диск загрузчика файл <code>left</code>"
       - "Повторите действия для правой половинки, используя файл <code>right</code>"
+      - "После обновления импортируйте сохранённую раскладку"
+    note: "Если при копировании прошивки появляется окно с ошибкой копирования/извлечения диска, просто игнорируйте это сообщение"
   en:
     title: How to update the firmware
     steps:
+      - 'Save the current layout in <a href="https://github.com/ergohaven/entropy" target="_blank" rel="noopener">Entropy</a> if needed'
       - "Download the firmware files for the left and right halves"
-      - "Connect the left half via USB-C, quickly double-press <code>Reset</code>, and copy the <code>left</code> file to the drive that opens"
+      - "Connect the left half via USB-C, quickly double-press <code>Reset</code> on the back of the case, and copy the <code>left</code> file to the bootloader drive that appears"
       - "Repeat these steps for the right half using the <code>right</code> file"
+      - "Import the saved layout after the update"
+    note: "If a copy or disk ejection error appears while copying the firmware, simply ignore the message"
 
 rmk_single:
   ru:
     title: Как обновить прошивку
     steps:
+      - 'При необходимости сохраните текущую раскладку в <a href="https://github.com/ergohaven/entropy" target="_blank" rel="noopener">Entropy</a>'
       - "Подключите устройство по USB-C и дважды быстро нажмите <code>Reset</code> на нижней части корпуса"
-      - "Скопируйте скачанный UF2-файл на открывшийся диск — после копирования устройство перезагрузится"
+      - "Скопируйте скачанный UF2-файл на появившийся диск загрузчика — после копирования устройство перезагрузится"
+      - "После обновления импортируйте сохранённую раскладку"
+    note: "Если при копировании прошивки появляется окно с ошибкой копирования/извлечения диска, просто игнорируйте это сообщение"
   en:
     title: How to update the firmware
     steps:
+      - 'Save the current layout in <a href="https://github.com/ergohaven/entropy" target="_blank" rel="noopener">Entropy</a> if needed'
       - "Connect the device via USB-C and quickly double-press <code>Reset</code> on the bottom of the case"
-      - "Copy the downloaded UF2 file to the drive that opens — the device will restart after copying"
+      - "Copy the downloaded UF2 file to the bootloader drive that appears — the device will restart after copying"
+      - "Import the saved layout after the update"
+    note: "If a copy or disk ejection error appears while copying the firmware, simply ignore the message"
 
 qmk:
   ru:
     title: Как обновить прошивку
     steps:
-      - "При необходимости сохраните текущую раскладку в Vial или Entropy"
+      - 'При необходимости сохраните текущую раскладку в <a href="https://github.com/ergohaven/entropy" target="_blank" rel="noopener">Entropy</a>'
       - "Подключите устройство по USB-C и дважды быстро нажмите <code>Reset</code> на нижней части корпуса"
-      - "Скопируйте скачанный UF2-файл на открывшийся диск — после копирования устройство перезагрузится"
+      - "Скопируйте скачанный UF2-файл на появившийся диск — после копирования устройство перезагрузится"
       - "Если клавиатура состоит из двух половинок, повторите эти действия для второй половинки"
       - "После обновления импортируйте сохранённую раскладку"
   en:
     title: How to update the firmware
     steps:
-      - "Save the current layout in Vial or Entropy if needed"
+      - 'Save the current layout in <a href="https://github.com/ergohaven/entropy" target="_blank" rel="noopener">Entropy</a> if needed'
       - "Connect the device via USB-C and quickly double-press <code>Reset</code> on the bottom of the case"
-      - "Copy the downloaded UF2 file to the drive that opens — the device will restart after copying"
+      - "Copy the downloaded UF2 file to the drive that appears — the device will restart after copying"
       - "If the keyboard has two halves, repeat these steps for the other half"
       - "Import the saved layout after the update"
 
 qmk_single:
   ru:
     title: Как обновить прошивку
     steps:
-      - "При необходимости сохраните текущую раскладку в Vial или Entropy"
+      - 'При необходимости сохраните текущую раскладку в <a href="https://github.com/ergohaven/entropy" target="_blank" rel="noopener">Entropy</a>'
       - "Подключите устройство по USB-C и дважды быстро нажмите <code>Reset</code> на нижней части корпуса"
-      - "Скопируйте скачанный UF2-файл на открывшийся диск — после копирования устройство перезагрузится"
+      - "Скопируйте скачанный UF2-файл на появившийся диск — после копирования устройство перезагрузится"
       - "После обновления импортируйте сохранённую раскладку"
   en:
     title: How to update the firmware
     steps:
-      - "Save the current layout in Vial or Entropy if needed"
+      - 'Save the current layout in <a href="https://github.com/ergohaven/entropy" target="_blank" rel="noopener">Entropy</a> if needed'
       - "Connect the device via USB-C and quickly double-press <code>Reset</code> on the bottom of the case"
-      - "Copy the downloaded UF2 file to the drive that opens — the device will restart after copying"
+      - "Copy the downloaded UF2 file to the drive that appears — the device will restart after copying"
       - "Import the saved layout after the update"
 
 zmk_split:
   ru:
     title: Как обновить прошивку
     steps:
       - "Скачайте все показанные файлы для левой и правой половинок"
-      - "Подключите левую половинку по USB-C, дважды быстро нажмите <code>Reset</code> и скопируйте на открывшийся диск файл <code>left</code>"
+      - "Подключите левую половинку по USB-C, дважды быстро нажмите <code>Reset</code> и скопируйте на появившийся диск файл <code>left</code>"
       - "Повторите действия для правой половинки, используя файл <code>right</code>"
       - "После обновления одновременно нажмите <code>Reset</code> на обеих половинках, чтобы восстановить их соединение"
   en:
     title: How to update the firmware
     steps:
       - "Download all displayed files for the left and right halves"
-      - "Connect the left half via USB-C, quickly double-press <code>Reset</code>, and copy the <code>left</code> file to the drive that opens"
+      - "Connect the left half via USB-C, quickly double-press <code>Reset</code>, and copy the <code>left</code> file to the drive that appears"
       - "Repeat these steps for the right half using the <code>right</code> file"
       - "After the update, press <code>Reset</code> on both halves simultaneously to reconnect them"
 
@@ -93,37 +105,37 @@ zmk_single:
     title: Как обновить прошивку
     steps:
       - "Подключите устройство по USB-C и дважды быстро нажмите <code>Reset</code> на нижней части корпуса"
-      - "Скопируйте скачанный UF2-файл на открывшийся диск — после копирования устройство перезагрузится"
+      - "Скопируйте скачанный UF2-файл на появившийся диск — после копирования устройство перезагрузится"
   en:
     title: How to update the firmware
     steps:
       - "Connect the device via USB-C and quickly double-press <code>Reset</code> on the bottom of the case"
-      - "Copy the downloaded UF2 file to the drive that opens — the device will restart after copying"
+      - "Copy the downloaded UF2 file to the drive that appears — the device will restart after copying"
 
 service_rmk:
   ru:
     title: Как использовать прошивку сброса
     steps:
       - "Подключите устройство или половинку клавиатуры по USB-C и дважды быстро нажмите <code>Reset</code>"
-      - "Скопируйте файл сброса RMK на открывшийся диск"
+      - "Скопируйте файл сброса RMK на появившийся диск"
       - "После перезагрузки установите обычную прошивку для вашей модели; для сплит-клавиатуры повторите действия на обеих половинках"
   en:
     title: How to use the reset firmware
     steps:
       - "Connect the device or keyboard half via USB-C and quickly double-press <code>Reset</code>"
-      - "Copy the RMK reset file to the drive that opens"
+      - "Copy the RMK reset file to the drive that appears"
       - "After the device restarts, install the regular firmware for your model; repeat the steps on both halves of a split keyboard"
 
 service_zmk:
   ru:
     title: Как использовать прошивку сброса
     steps:
       - "Подключите устройство или половинку клавиатуры по USB-C и дважды быстро нажмите <code>Reset</code>"
-      - "Скопируйте файл сброса ZMK на открывшийся диск"
+      - "Скопируйте файл сброса ZMK на появившийся диск"
       - "После перезагрузки установите обычную прошивку для вашей модели; для сплит-клавиатуры повторите действия на обеих половинках"
   en:
     title: How to use the reset firmware
     steps:
       - "Connect the device or keyboard half via USB-C and quickly double-press <code>Reset</code>"
-      - "Copy the ZMK reset file to the drive that opens"
+      - "Copy the ZMK reset file to the drive that appears"
       - "After the device restarts, install the regular firmware for your model; repeat the steps on both halves of a split keyboard"

layouts/shortcodes/firmware-picker.html

@@ -110,6 +110,9 @@
                   <li>{{ . | safeHTML }}</li>
                 {{- end }}
               </ol>
+              {{- with .note }}
+                <p class="firmware-picker__instruction-note">{{ . | safeHTML }}</p>
+              {{- end }}
             </div>
           {{- end }}
         </section>