docs: keep the start pages under their ceilings

tests/test_site_r5_wiki.py

@@ -68,7 +68,7 @@ class NoSetupFoundGivesEachSystemItsFolder(unittest.TestCase):
         self.assertIn('print("  No supported platform detected.")', INSTALL_PY)
 
     def test_the_lead_names_the_menu(self):
-        self.assertIn("In RetroArch, open **Settings > Directory > System/BIOS**",
+        self.assertIn("Not sure? Open RetroArch's **Settings > Directory > System/BIOS**",
                       _flat(self.section))
 
     def test_each_tab_carries_the_folder_retroarch_reads_there(self):
@@ -151,14 +151,14 @@ class FaqAnswersLeadSomewhere(unittest.TestCase):
 
     def test_ios_goes_to_the_iphone_section(self):
         section = _flat(_section(self.text, "My setup is not in the list"))
-        self.assertIn("iPhone, iPad (iOS): no terminal. [Pick your consoles and copy the files "
+        self.assertIn("iPhone, iPad (iOS): no terminal. [Pick your consoles and copy them "
                       "to the app](../which-pack.md#iphone-and-ipad).", section)
         self.assertNotIn("Use the ZIP", section)
         self.assertIn('"## iPhone and iPad { #iphone-and-ipad }"', self.generator)
 
     def test_antivirus_answer_covers_setups_without_a_zip(self):
         section = _flat(_section(self.text, "Windows or my antivirus blocks the command"))
-        self.assertIn("No ZIP for your setup? [Pick your consoles]"
+        self.assertIn("Use your setup's ZIP. None? [Pick your consoles]"
                       "(../which-pack.md#only-some-consoles) and download their files.",
                       section)
         self.assertNotIn("if any", section)
@@ -211,7 +211,7 @@ class SmallCopyFixes(unittest.TestCase):
 
     def test_retropie_share_is_named_with_its_source(self):
         section = _section(_wiki("first-install.md"), "Error: Python 3.8 or newer is required.")
-        self.assertIn("From\nWindows, it is `\\\\RETROPIE\\bios`:", section)
+        self.assertIn("share open, `\\\\RETROPIE\\bios` from Windows:", section)
         self.assertIn("samba.sh:49-52", section)
         self.assertIn("Transferring-Roms.md:29", section)
 

wiki/faq.md

@@ -67,13 +67,13 @@ Read them first: [install.sh](https://github.com/Abdess/retrobios/blob/main/inst
 
 ## Windows or my antivirus blocks the command
 
-Use your setup's ZIP. No ZIP for your setup?
-[Pick your consoles](../which-pack.md#only-some-consoles) and download their files.
+Use your setup's ZIP. None? [Pick your consoles](../which-pack.md#only-some-consoles)
+and download their files.
 
 ## Why is there no ZIP for my setup?
 
-ZIPs are made for the setups most people download. The command installs every
-setup's files and checks each one. `--dry-run` shows the list first.
+ZIPs exist for the most downloaded setups. The command installs and checks
+every setup's files.
 
 ## Fill an SD card from a computer?
 
@@ -101,7 +101,7 @@ Fill it from a computer, as above, or point `--from-pack` at your ZIP: [Without
 - Name your emulator's BIOS folder with `--dest`.
 - ES-DE, LaunchBox: the command fills their emulators' folders.
 - iPhone, iPad (iOS): no terminal.
-  [Pick your consoles and copy the files to the app](../which-pack.md#iphone-and-ipad).
+  [Pick your consoles and copy them to the app](../which-pack.md#iphone-and-ipad).
 
 ## Why is a file missing from the ZIP?
 

wiki/first-install.md

@@ -141,9 +141,8 @@ Choose **Another setup or folder**, then your setup and its folder.
 The message shows the command that installs Python. Run it, then run the
 installer again.
 
-A RetroPie 4.8 image has Python 3.7.3, and its update command finds nothing
-newer. Run it on a computer, with RetroPie's `bios` network folder open. From
-Windows, it is `\\RETROPIE\bios`:
+RetroPie 4.8 has Python 3.7.3, and its update finds nothing newer. Run it on
+a computer, with RetroPie's `bios` share open, `\\RETROPIE\bios` from Windows:
 
 <!-- RetroPie-Setup scriptmodules/supplementary/samba.sh:49-52 (46128cd2) shares
 $home/RetroPie/BIOS as "bios", and RetroPie docs/Transferring-Roms.md:29 names

wiki/troubleshooting.md

@@ -33,7 +33,7 @@ Read the count line:
 
 - **`wrong hash`**: another region or model, or damaged.
 - **Fewer present than the total**: files are missing.
-- **A line under a file**, like `still zipped`, says what to fix.
+- **A line under a file**, like `still zipped`, says the fix.
 - **`0 wrong hash`, all present**: go to step 3.
 
 ## 2. Fix the files
@@ -44,11 +44,11 @@ Without `--check`, it adds missing files and replaces wrong ones.
 
 - **Right folder?** [Get your files](../which-pack.md) names it.
 - **Exact name?** `scph5501.bin` and `SCPH-5501.BIN` differ.
-- **A `bios` folder inside your BIOS folder?** Run the installer: it copies
-  those files up one level.
+- **A `bios` folder inside your BIOS folder?** The installer copies those
+  files up one level.
 - **BIOS setting on a subfolder, like `system/dc`?** Point it at the BIOS
   folder. Emulators add their own, like `dc/` for Flycast.
-- **A ZIP in parts, like `Pack.part1of2.zip`?** Unzip every part into one
+- **A ZIP in parts, like `Pack.part1of2.zip`?** Unzip all parts into one
   folder.
 
 <!-- Flycast's libretro port appends "dc/" to the system directory:
@@ -65,7 +65,7 @@ version.
 
 ## The BIOS is fine, the game still fails
 
-- **Another emulator?** Each reads its own files, listed on its page.
+- **Another emulator?** Each reads the files listed on its page.
 - **A BIOS setting?** Some emulators can skip the BIOS. In PCSX ReARMed, set
   **BIOS Selection** to **Auto**.
 - **The screen says "Please insert PlayStation CD-ROM"?** The BIOS works.
@@ -76,9 +76,8 @@ version.
 - **Network error:** try again later.
 - **`The clock reads ...`:** set the right date.
 - **Permission denied:** do what the message says.
-- **`No supported platform detected`:** name your setup and its folder.
-  Not sure of the folder? In RetroArch, open **Settings > Directory >
-  System/BIOS**.
+- **`No supported platform detected`:** name the folder. Not sure? Open
+  RetroArch's **Settings > Directory > System/BIOS**.
 
 <!-- The folders RetroArch reads by default, as install.py writes them
 (_os_default_dests, _macos_retroarch_base) and the RetroArch setup page