From 1eacbae4f2e6d56a067689385c7926a92f2880c7 Mon Sep 17 00:00:00 2001
From: Abdessamad Derraz <3028866+Abdess@users.noreply.github.com>
Date: Fri, 7 Aug 2026 18:57:06 +0200
Subject: [PATCH] docs: align claims with source-backed counts

---
 scripts/generate_readme.py | 9 ++++++---
 scripts/generate_site.py   | 6 ++++--
 2 files changed, 10 insertions(+), 5 deletions(-)

diff --git a/scripts/generate_readme.py b/scripts/generate_readme.py
index 83a1814e..4aae33ef 100644
--- a/scripts/generate_readme.py
+++ b/scripts/generate_readme.py
@@ -206,8 +206,9 @@ def generate_readme(db: dict, platforms_dir: str) -> str:
             "## What's included",
             "",
             "BIOS, firmware, and system files for consoles from Atari to PlayStation 3.",
-            "Each file is checked against the emulator's source code to match what the"
-            " code actually loads at runtime.",
+            "Every file passes its platform's own verification; where an emulator"
+            " profile exists, the expected hashes and sizes are read from the"
+            " emulator's source code (the Source-backed column below).",
             "",
             f"- **{len(coverages)} platforms** supported with platform-specific verification",
             f"- **{emulator_count} emulators** profiled from source (RetroArch cores + standalone)",
@@ -337,7 +338,9 @@ def generate_readme(db: dict, platforms_dir: str) -> str:
             "## How it works",
             "",
             "Documentation and metadata can drift from what emulators actually load.",
-            "To keep packs accurate, each file is checked against the emulator's source code.",
+            "To keep packs accurate, platform lists are checked against emulator"
+            " source code, file by file where a profile exists; when the two"
+            " disagree, the code wins.",
             "",
             "1. **Read emulator source code** - trace every file the code loads, its expected hash and size",
             "2. **Cross-reference with platforms** - match against what each platform declares",
diff --git a/scripts/generate_site.py b/scripts/generate_site.py
index 516e7f0a..047874a1 100644
--- a/scripts/generate_site.py
+++ b/scripts/generate_site.py
@@ -265,7 +265,8 @@ def generate_home(
         "",
         f"# {SITE_NAME}",
         "",
-        "Source-verified BIOS and firmware packs for retrogaming platforms.",
+        "BIOS and firmware packs verified with each platform's own checks, "
+        "with emulator source code as the deciding authority.",
         "",
         "</div>",
         "",
@@ -371,7 +372,8 @@ def generate_home(
             "",
             '??? abstract "Methodology"',
             "",
-            "    Each file is checked against the emulator's source code. "
+            "    Platform lists are checked against emulator source code, file "
+            "by file where a profile exists ([Source-backed counts](gaps.md)). "
             "Documentation and metadata can drift from actual runtime behavior, "
             "so the source is the primary reference.",
             "",