Skip to content

Guided tour of the Explorer replaces the migration-era Zenodo analysis tutorial#339

Merged
rdhyee merged 4 commits into
isamplesorg:mainfrom
rdhyee:feat/explorer-guided-tour
Jul 24, 2026
Merged

Guided tour of the Explorer replaces the migration-era Zenodo analysis tutorial#339
rdhyee merged 4 commits into
isamplesorg:mainfrom
rdhyee:feat/explorer-guided-tour

Conversation

@rdhyee

@rdhyee rdhyee commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

🤖 rbotyee (Claude, operated by @rdhyee) — Raymond's intent: the old Zenodo deep-dive tutorial "seems totally out of place now"; replace it with a walkthrough of what the Explorer's views can teach (decision 2026-07-24: option B, audience = future users/colleagues, replace the URL). What I did: wrote the tour, 4 Codex rounds to LGTM.

BLUF

New: A Guided Tour: What 6.7 Million Samples Can Tell You — seven stops through the Explorer, each a live deep link (the URL-state work makes every view shareable), three of them with a small "the number behind the view" DuckDB-WASM cell computing what you're seeing from the canonical KB-scale files (per CANONICAL.md). Bridges viewer → analyst, which was the old page's one genuine virtue — done against the right files this time.

Removed: zenodo_isamples_analysis.qmd (2025-09-05, migration era). It pinned non-canonical 202601 files and its CORS fallback chain is broken today — the data Worker 403s HEAD requests, so the page silently demos fake data. Old URL redirects via Quarto alias; every in-site reference (navbar, sidebar, how-to-use incl. the tutorial/data matrix, README, SERIALIZATIONS, cross-tutorial links, 3 test files) updated.

Honesty notes (things the review made true)

  • "~6.7M covered, ~6M on the globe" — the 700K coordinate-less records are world-search-only, and the tour says so
  • CSV export: "up to 50,000 rows" (the actual cap), not "exactly what you filtered"
  • Place-name search matches place metadata, not coordinates
  • Fly-to links use 150 km altitude so mode=point actually engages (point-mode threshold is 180 km)
  • Densest-cell claim scoped to the res4 aggregate near Çatalhöyük
  • Load test now waits for a rendered Plot SVG — proving OJS + DuckDB + a live remote query, not just DOM

Review trail: round 1 (4 P1 — stale refs, overpromised links, CSV, place-name mechanism), round 2 (2 P1 — data matrix, located/unlocated claims), round 3 (1 P2 matrix dup), round 4 LGTM. 52 Python contract tests + 111 JS unit tests + render all pass.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Nohddj7oXLnkJ4P9Cibg8Y

rdhyee and others added 4 commits July 24, 2026 08:20
…analysis

Seven stops, each a live deep link (URL-state round-trips make every view
shareable) + three "number behind the view" DuckDB-WASM cells querying ONLY
canonical KB-scale files (facet_summaries, vocab_labels, h3_res4 — per
CANONICAL.md). Honest data notes: 6.03M located vs 6.7M total; densest
cell = Catalhoyuk region. Old page removed (its HEAD-probe fallback chain
is broken by the Worker's HEAD-403 today, silently demoing fake data);
Quarto alias redirects the old URL. RY decision 2026-07-24: option B,
future users/colleagues, replace.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Nohddj7oXLnkJ4P9Cibg8Y
- Every stale reference to the deleted tutorial updated (navbar+sidebar,
  explorer footer, how-to-use, README, SERIALIZATIONS consumer note,
  narrow_vs_wide + archive links, 3 test files now assert 'Guided Tour')
- Deep-link honesty: intro promise softened to what URLs actually carry;
  Anatolia links 300km -> 150km so mode=point is real (point-mode
  threshold is 180km); densest-cell claim scoped to the res4 aggregate
- CSV claim corrected to the 50,000-row cap; place-name search mechanism
  corrected to place metadata (not coordinates)
- Source bars use the real SOURCE_COLORS palette; vocab join constrained
  to lang='en'
- Note: CANONICAL.md link resolves on merge (PR isamplesorg#338 landed on main
  after this branch was cut — merge brings them together)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Nohddj7oXLnkJ4P9Cibg8Y
…test rigor

- how-to-use matrix: Guided Tour uses facet_summaries + vocab_labels +
  h3_res4 (not wide_h3); vocab_labels row added
- intro says ~6.7M covered / ~6M on the globe; unlocated records correctly
  described as world-search-only (not in the viewport table); alt text
  scoped to the res4 cell in cluster view
- tests: identifiers renamed; landing locator scoped to main content so
  the navbar link can't false-pass it; load test now waits for the first
  Plot SVG (proves OJS boot + DuckDB + remote query, not just DOM)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Nohddj7oXLnkJ4P9Cibg8Y
@rdhyee rdhyee added the CC+Codex+LGTM Claude and Codex both reached LGTM; ready for human review label Jul 24, 2026
@rdhyee
rdhyee merged commit 9687fbf into isamplesorg:main Jul 24, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CC+Codex+LGTM Claude and Codex both reached LGTM; ready for human review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant