Skip to content

Tutorials query /current/wide.parquet instead of dated file#134

Merged
rdhyee merged 1 commit intoisamplesorg:mainfrom
rdhyee:feat/tutorials-use-current-wide
Apr 17, 2026
Merged

Tutorials query /current/wide.parquet instead of dated file#134
rdhyee merged 1 commit intoisamplesorg:mainfrom
rdhyee:feat/tutorials-use-current-wide

Conversation

@rdhyee
Copy link
Copy Markdown
Contributor

@rdhyee rdhyee commented Apr 17, 2026

Follow-up to #131/#133. Three runtime tutorial pages (Interactive Explorer, Search Explorer, Deep-Dive Analysis) now go through the stable /current/ alias so they automatically pick up OC-thumbnail enrichment and any future rotations. Benchmark page keeps its dated URL for reproducibility. Data catalog docs updated to explain the alias vs. pinned-date trade.

Interactive Explorer, Search Explorer, and Deep-Dive Analysis now
query through the stable /current/ alias so they pick up the current
enriched wide parquet (with OpenContext thumbnails) without needing
per-tutorial URL updates on rebuild. The alias 302-redirects to the
latest dated file; DuckDB-WASM follows redirects transparently and
range requests after the redirect go to the target directly.

- tutorials/progressive_globe.qmd: wide_url (lazy description fetch
  on sample click; v2 explorer description fetch)
- tutorials/isamples_explorer.qmd: wide_url (v1 primary source)
- tutorials/zenodo_isamples_analysis.qmd: primary data source

narrow_vs_wide_performance.qmd intentionally keeps dated URLs —
benchmarks need reproducibility, not freshness.

Data catalog updates:
- how-to-use.qmd: document the /current/ alias pattern, explain the
  trade (stable alias for interactive work vs. dated URL for pinned
  reproducibility), preserve historical isamples_202601_wide.parquet
  pointer for anyone pinning.
- tutorials/index.qmd: primary Wide format row points at the alias
  and notes the rotation convention.

Closes the "#2" item from isamplesorg#131's status comment (migrate tutorials to
/current/wide.parquet).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant