From f1ce63fe5cf5dd700223877b3ab56a51ef743847 Mon Sep 17 00:00:00 2001
From: Abdessamad Derraz <3028866+Abdess@users.noreply.github.com>
Date: Thu, 5 Nov 2026 12:05:08 +0100
Subject: [PATCH] docs: name the SHARE drive folder for a card

---
 platforms/_guides.yml     |  6 ++++--
 tests/test_pack_readme.py | 16 ++++++++++++++++
 2 files changed, 20 insertions(+), 2 deletions(-)

diff --git a/platforms/_guides.yml b/platforms/_guides.yml
index d07af1e2c..2a886327d 100644
--- a/platforms/_guides.yml
+++ b/platforms/_guides.yml
@@ -335,7 +335,8 @@ guides:
       Option C: Manual (SD card)
       --------------------------
       1. Put the SD card in your PC
-      2. Navigate to /userdata/bios/ on the SHARE partition
+      2. Open the bios folder at the root of the SHARE drive
+         (Batocera itself names it /userdata/bios/)
       3. Extract all files from this archive directly into that folder
 
       NOTE: Dreamcast flash memory is named dc_nvmem.bin
@@ -368,7 +369,8 @@ guides:
       Option C: Manual (SD card)
       --------------------------
       1. Put the SD card in your PC
-      2. Navigate to /recalbox/share/bios/
+      2. Open the bios folder at the root of the SHARE drive
+         (Recalbox itself names it /recalbox/share/bios/)
       3. Extract all files from this archive directly into that folder
     logo_owner: Recalbox
     logo_licence: file from homarr-labs/dashboard-icons, Apache-2.0
diff --git a/tests/test_pack_readme.py b/tests/test_pack_readme.py
index 9218843ca..786ccd882 100644
--- a/tests/test_pack_readme.py
+++ b/tests/test_pack_readme.py
@@ -44,6 +44,22 @@ class GuidesPointAtTheReadPath(unittest.TestCase):
                 )
 
 
+class ACardOpenedOnAComputerShowsItsShareDrive(unittest.TestCase):
+    """The SD card steps said /userdata/bios/ and /recalbox/share/bios/,
+    paths of the running system. On a computer the SHARE drive opens at its
+    root, bios/ beside roms/ and system/, and no such folder exists."""
+
+    def test_the_card_steps_name_the_drive_folder(self):
+        for name in ("batocera", "recalbox"):
+            text = _build_readme(name, name, "", 1, 1)
+            card = text[text.index("Manual (SD card)"):]
+            card = card[:card.index("\n\n", card.index("1."))]
+            with self.subTest(platform=name):
+                self.assertIn("bios folder at the root of the SHARE drive", card)
+                self.assertNotIn("/userdata/bios/ on", card)
+                self.assertNotIn("Navigate to /recalbox", card)
+
+
 class GuidesNameShippedInstallers(unittest.TestCase):
     def test_every_installer_named_exists(self):
         """RetroBat's guide sent users to an install.bat no release carries."""