Add fictional example walkthrough to Start Here

public_space_app.py

@@ -121,7 +121,7 @@ def _about_release_markdown(
             "",
             "- Journalists can use it to move from a vague suspicion to a concrete set of records worth checking.",
             "- Researchers can use it to compare members, sectors, and funding-recipient patterns without pulling six public sources by hand.",
-            "- Citizens can use it to see why a relationship appears, then open the actual published source URLs and SHA-backed artifacts.",
+            "- Citizens can use it to see why a relationship appears, then open the actual published source URLs and SHA-backed artifacts (cryptographic hashes used to help show a published record has not been altered).",
             "",
             "## What this does not claim",
             "",
@@ -157,21 +157,29 @@ def _about_release_markdown(
 def _data_used_markdown(manifest: Dict[str, Any]) -> str:
     summary = manifest.get("methodology_summary") or {}
     source_groups = _split_source_group_lines(summary.get("source_groups"))
+    source_pairs = [
+        ("House Clerk financial disclosures and PTRs", "Show trades or financial holdings disclosed by House members."),
+        ("House Clerk member directory and committee list", "Identify who the members are and what committee context they have."),
+        ("GovInfo BILLSTATUS bulk data", "Show bill activity tied to the same policy area."),
+        ("House Clerk roll-call vote XML", "Show vote activity tied to the same policy area."),
+        ("FEC public bulk downloads", "Add campaign-finance context where it is used in the released slice."),
+        ("LDA public search pages", "Add lobbying visibility around the same issue areas."),
+        ("House member community project funding disclosure pages", "Show member-published funding-request disclosures."),
+        ("USAspending award pages used for some recipient matching", "Show public award records used to support some funding-recipient links."),
+    ]
     return "\n".join(
         [
             "## What data is used here",
             "",
             "This release combines public records from these source groups:",
             "",
-            *[f"- {item}" for item in source_groups],
-            "",
-            "## In plain English, what those sources add",
-            "",
-            "- Disclosure records show trades or financial holdings.",
-            "- Bill and vote records show legislative activity in related policy areas.",
-            "- Committee records show formal committee context.",
-            "- Lobbying and campaign-finance visibility add more public context around the same issue areas.",
-            "- Community project funding records and award pages help show recipient-side relationships.",
+            "| Source | What it adds |",
+            "| --- | --- |",
+            *[
+                f"| {source} | {purpose} |"
+                for source, purpose in source_pairs
+                if source in source_groups or source == "USAspending award pages used for some recipient matching"
+            ],
             "",
             "## How those records show up in this release",
             "",
@@ -181,6 +189,7 @@ def _data_used_markdown(manifest: Dict[str, Any]) -> str:
             "- `evidence_audit/*`: source URLs, SHA-256 values, and public-safe provenance rows for verification.",
             "",
             "Not every internal raw record is published here. The public package is a bounded, sanitized release layer.",
+            "When this app says a row has a SHA-backed artifact, it means the release includes a cryptographic hash that helps show the published record has not been altered.",
         ]
     )