From 19974e34b8e45f50564186928d0856425c99b579 Mon Sep 17 00:00:00 2001
From: Abdessamad Derraz <3028866+Abdess@users.noreply.github.com>
Date: Tue, 20 Oct 2026 13:33:53 +0200
Subject: [PATCH] docs: state only checked facts on the exports page

The intro gave an opinion on the effort lists take and said nothing is removed, while RetroArch and Lakka lose three hashes and one size. It now says no entry is removed, that dropped values are listed per platform, and names exactly what the tests run on patched code.
---
 scripts/siteexports.py | 23 +++++++++++++----------
 1 file changed, 13 insertions(+), 10 deletions(-)

diff --git a/scripts/siteexports.py b/scripts/siteexports.py
index 7f47287a..bdbbb36d 100644
--- a/scripts/siteexports.py
+++ b/scripts/siteexports.py
@@ -92,19 +92,22 @@ def generate_exports_page(reports: list[dict], names: dict[str, str]) -> str:
         "",
         "Each platform keeps its own list of the BIOS files it checks: "
         "libretro's `System.dat`, Batocera's `batocera-systems`, Recalbox's "
-        "`es_bios.xml` and so on. Keeping such a list in step with every "
-        "emulator release is a lot of work. This project reads the emulators' "
-        "source code file by file, and offers each platform its own file with "
-        "those findings applied: a hash is updated where the emulator source "
-        "states another, files the platform's emulators read are added, and "
-        "nothing the platform declares is removed. Code the file carries (a "
-        "checker script, a C# database, a shell library) is patched in place "
-        "and keeps working.",
+        "`es_bios.xml` and so on. This project reads the emulators' source "
+        "code file by file, and offers each platform its own file with those "
+        "findings applied: a hash is updated where the emulator source states "
+        "another, files the platform's emulators read are added, and no entry "
+        "the platform declares is removed. Where a value of an entry is "
+        "dropped, the platform's section lists it. Code the file carries is "
+        "patched in place. With the original files on hand, the tests run "
+        "the updated Batocera and ROCKNIX scripts (`--createReadme`), parse "
+        "`checkBIOS.sh` and the RetroPie scriptmodules with `bash -n`, and "
+        "check that every Recalbox entry carries the attributes the "
+        "`es_bios.xsd` Recalbox publishes requires.",
         "",
         "Each file starts from the revision of the original that this project "
         "last read, so it compares cleanly with it, and every change can be "
-        "taken or left on its own. Each value traces back to the emulator code "
-        "cited on its profile page. If a change does not fit a platform, an "
+        "taken or left on its own. Each value comes from an emulator profile, "
+        "whose page cites where it was read. If a change does not fit a platform, an "
         "issue on the [repository](https://github.com/Abdess/retrobios/issues) "
         "is welcome: this project's profile is revised, and every platform's "
         "file follows.",