feat: describe the data exports as a Dataset

scripts/generate_site.py

@@ -1216,6 +1216,36 @@ def _page_description(markdown: str, relative: Path, title: str) -> str:
 PAGE_DATA: dict[str, dict] = {}
 
 
+def dataset_structured_data(exports: list[dict], db: dict) -> dict:
+    """The data page as a schema.org Dataset a harvester can index.
+
+    It was a Dataset named "Data & API" with no download, licence, date or
+    creator, so Google Dataset Search and open-data catalogues had nothing
+    to list. The exports are metadata this project authors: MIT, as the
+    LICENSE's scope says.
+    """
+    data: dict = {
+        "name": f"{SITE_NAME} collection data",
+        "license": "https://opensource.org/licenses/MIT",
+        "creator": {"@type": "Organization", "name": SITE_NAME, "url": REPO_URL},
+        "distribution": [
+            {
+                "@type": "DataDownload",
+                "name": item["title"],
+                "contentUrl": urllib.parse.urljoin(SITE_URL, item["url"]),
+                "encodingFormat": item["media_type"],
+                "contentSize": f"{item['bytes']} B",
+                "sha256": item["sha256"],
+            }
+            for item in exports
+        ],
+    }
+    generated = str(db.get("generated_at") or "")[:10]
+    if generated:
+        data["dateModified"] = generated
+    return data
+
+
 def emulator_structured_data(profile: dict) -> dict:
     """What an emulator page states, for a reader of its JSON-LD.
 
@@ -4064,6 +4094,7 @@ def main() -> None:
         docs, db, coverages, profiles, stats, gap_report
     )
     write_if_changed(str(docs / "data.md"), generate_data_page(exports))
+    PAGE_DATA["data.md"] = dataset_structured_data(exports, db)
 
     # Build system_id -> manufacturer page map (needed by all generators)
     print("Building system cross-reference map...")

tests/test_audit_regressions.py

@@ -4670,5 +4670,25 @@ class SiteCodeSpansHoldTheirValue(unittest.TestCase):
         self.assertTrue(span.startswith("`") and span.endswith("`"))
 
 
+
+class TheDatasetDescribesItsDownloads(unittest.TestCase):
+    """data.md was a Dataset named "Data & API" with no distribution,
+    licence, date or creator: nothing a dataset harvester could index."""
+
+    def test_distribution_licence_and_date(self):
+        from scripts.generate_site import dataset_structured_data
+
+        exports = [{"title": "Content database", "url": "api/v1/database.json",
+                    "media_type": "application/json", "bytes": 10, "sha256": "ab" * 32}]
+        data = dataset_structured_data(exports, {"generated_at": "2026-10-18T07:00:00Z"})
+        self.assertEqual(data["dateModified"], "2026-10-18")
+        self.assertIn("MIT", data["license"])
+        (download,) = data["distribution"]
+        self.assertEqual(download["@type"], "DataDownload")
+        self.assertTrue(download["contentUrl"].endswith("/api/v1/database.json"))
+        self.assertEqual(download["sha256"], "ab" * 32)
+        self.assertNotEqual(data["name"], "Data & API")
+
+
 if __name__ == "__main__":
     unittest.main()