Skip to content

Commit f7f558b

Browse files
authored
Merge pull request #360 from rdhyee/docs/closeout-current-alias
Closeout: fix two dead toolbar buttons and the clipped help panel; say what /current/ is pinned to
2 parents ae32bbb + 81f423f commit f7f558b

6 files changed

Lines changed: 58 additions & 14 deletions

File tree

‎SERIALIZATIONS.md‎

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -180,8 +180,9 @@ from a sidecar. A future `isamples_202601_oc_sidecar.parquet` (keyed on
180180
URL convention: each file is available at
181181
`https://data.isamples.org/<filename>` (versioned, 1-yr immutable cache)
182182
and, where applicable, at `https://data.isamples.org/current/<alias>`
183-
(302 redirect, 5-min cache). Examples below use the versioned URL; swap
184-
for the alias when you want "latest."
183+
(302 redirect, 5-min cache). Examples below use the versioned URL. The
184+
alias is a stable address, not a promise of the newest release — see §5
185+
for what it currently points at.
185186

186187
### 4.1 Zenodo export (source of truth)
187188

@@ -407,9 +408,11 @@ Cloudflare Worker fronting an R2 bucket. The Worker provides:
407408
— 1-year immutable cache. Safe to pin in papers, Zenodo manifests,
408409
reproducibility notebooks.
409410
- **Alias URLs** `https://data.isamples.org/current/<alias>` — 302
410-
redirect with 5-min cache; always resolves to the latest snapshot.
411-
Use for "always fresh" consumers. Currently
412-
`current/wide.parquet → isamples_202604_wide.parquet`.
411+
redirect with 5-min cache to a dated file. Currently
412+
`current/wide.parquet → isamples_202604_wide.parquet`, the April 2026
413+
wide file the tutorials were written against. It was deliberately left
414+
there when the Explorer moved to the `isamples_202609_*` release
415+
(September 2026), so it is not the newest snapshot.
413416

414417
**Never reference the raw
415418
`pub-a18234d962364c22a50c787b7ca09fa5.r2.dev/...` URL.** It bypasses

‎data.qmd‎

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -49,8 +49,13 @@ Two places depending on what you need:
4949
Cloudflare R2. HTTP range requests supported; DuckDB and DuckDB-WASM
5050
work directly against URLs. Two layers:
5151
- `/<versioned-file>.parquet` — 1-year immutable cache. Pin in papers.
52-
- `/current/<alias>.parquet` — 302 redirect to the latest snapshot.
53-
Use for "always fresh." Currently aliases:
52+
- `/current/<alias>.parquet` — 302 redirect to a dated file, so
53+
tutorials and notebooks have one stable address. It is **not** the
54+
newest release: it is pinned to the April 2026 wide file the
55+
tutorials were written against, while the Explorer reads the
56+
`isamples_202609_*` files (see the
57+
[release manifest](https://isamples.org/isamples_202609_release_manifest.json)).
58+
Currently aliases:
5459
- `/current/wide.parquet` → `isamples_202604_wide.parquet`
5560
- **[iSamples Zenodo community](https://zenodo.org/communities/isamples)**
5661
— long-term archival with DOIs. The raw aggregated export is

‎explorer.qmd‎

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -450,6 +450,34 @@ format:
450450
position: relative;
451451
z-index: 1100;
452452
}
453+
/* The rule above has a side effect, found 2026-10-07 by clicking every
454+
toolbar button on the live site: the wrapper now sits above its
455+
later siblings even while the picker is COLLAPSED, and its box
456+
extends over the two buttons below it (the hidden 2D/Columbus
457+
buttons still occupy that space). So the imagery picker and the
458+
"?" help button received no clicks at all. Let clicks fall through
459+
the wrapper and its hidden buttons; the visible ones still take
460+
them, so #324 stays fixed. */
461+
.cesium-sceneModePicker-wrapper { pointer-events: none; }
462+
.cesium-sceneModePicker-wrapper > button { pointer-events: auto; }
463+
.cesium-sceneModePicker-wrapper > button.cesium-sceneModePicker-hidden { pointer-events: none; }
464+
/* Navigation help ("?") panel. Cesium anchors it to the button's RIGHT
465+
edge and opens leftwards, which suits its default top-right toolbar.
466+
Our toolbar is top-left, so the panel opened 184px off the left edge
467+
of the globe and only a clipped stub was visible. Open it to the
468+
right of the toolbar instead, lifted so it fits inside the
469+
450px-high globe. */
470+
.cesium-navigation-help {
471+
left: 40px !important;
472+
right: auto !important;
473+
top: -150px !important;
474+
transform-origin: 0 150px !important;
475+
z-index: 1100;
476+
/* Cesium fixes the panel at 250px. On a phone-width globe that
477+
plus the 40px offset would run off the right edge, so let it
478+
shrink to what the viewport can hold. */
479+
max-width: calc(100vw - 96px);
480+
}
453481
.search-bar { display: flex; gap: 6px; }
454482
.search-bar input {
455483
flex: 1; padding: 8px 12px; border: 1px solid #ccc; border-radius: 4px;
@@ -2484,6 +2512,9 @@ viewer = {
24842512
timeline: false,
24852513
animation: false,
24862514
baseLayerPicker: true,
2515+
// Cesium auto-opens the navigation help on a visitor's first load.
2516+
// Keep the first view of the globe clear; "?" still opens it.
2517+
navigationInstructionsInitiallyVisible: false,
24872518
fullscreenElement: "cesiumContainer",
24882519
terrain: Cesium.Terrain.fromWorldTerrain()
24892520
});

‎how-to-use.qmd‎

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -79,11 +79,13 @@ The two main files carrying the sample records themselves:
7979
| [`isamples_202601_wide_h3.parquet`](https://data.isamples.org/isamples_202601_wide_h3.parquet) | 307 MB | Wide + H3 BIGINT indices (`h3_res4`, `h3_res6`, `h3_res8`) | 20.7 M | Geospatial queries with H3 clustering at arbitrary zoom |
8080
| [`isamples_202512_narrow.parquet`](https://data.isamples.org/isamples_202512_narrow.parquet) | 860 MB | Narrow (graph: nodes + explicit `_edge_` rows, s/p/o/n fields) | 101,387,180 | Graph traversals, relationship-centric analysis, PQG work |
8181

82-
∗ `/current/wide.parquet` is a stable alias that HTTP 302-redirects to the
83-
latest dated file (currently
82+
∗ `/current/wide.parquet` is a stable alias that HTTP 302-redirects to a
83+
dated file (currently
8484
[`isamples_202604_wide.parquet`](https://data.isamples.org/isamples_202604_wide.parquet),
85-
enriched with ~47 K OpenContext thumbnails). The dated filename is
86-
immutable; the alias rotates atomically when we rebuild. Use the alias for
85+
enriched with ~47 K OpenContext thumbnails). That is the April 2026 file
86+
these tutorials were written against, not the newest release: the
87+
Interactive Explorer reads the September 2026 `isamples_202609_*` files.
88+
The dated filename is immutable. Use the alias for
8789
interactive work, the dated URL when you want a pinned, reproducible
8890
reference. The original
8991
[`isamples_202601_wide.parquet`](https://data.isamples.org/isamples_202601_wide.parquet)

‎query-spec.qmd‎

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -333,8 +333,11 @@ Worker in front of the R2 bucket). Two layers:
333333

334334
- **Versioned** `/isamples_YYYYMM_<file>.parquet` — 1-yr immutable cache,
335335
safe to pin in papers, spec examples, or reproducibility notebooks.
336-
- **Alias** `/current/<alias>` — 302 redirect with 5-minute cache; tracks
337-
whatever the latest snapshot is. Use for "always fresh" consumers.
336+
- **Alias** `/current/<alias>` — 302 redirect with 5-minute cache to a
337+
dated file. As of October 2026 `/current/wide.parquet` is pinned to
338+
`isamples_202604_wide.parquet` (the file the tutorials use); it does
339+
**not** follow the Explorer's newer `isamples_202609_*` release. Pin a
340+
versioned URL when the exact snapshot matters.
338341

339342
Never reference the raw `pub-a18234d962364c22a50c787b7ca09fa5.r2.dev/...`
340343
URL — it bypasses the Worker and defeats the alias layer.

‎tutorials/index.qmd‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ All data is hosted on [`data.isamples.org`](https://data.isamples.org) with HTTP
4343

4444
| File | Size | Description |
4545
|------|------|-------------|
46-
| [Wide format](https://data.isamples.org/current/wide.parquet) | 292 MB | One row per entity, all sources — primary file for tutorials. Stable alias redirects to the current dated build (`isamples_YYYYMM_wide.parquet`). |
46+
| [Wide format](https://data.isamples.org/current/wide.parquet) | 292 MB | One row per entity, all sources — primary file for tutorials. Stable alias; currently redirects to the April 2026 build (`isamples_202604_wide.parquet`), not the Explorer's newer 202609 release. |
4747
| [Wide + H3](https://data.isamples.org/isamples_202601_wide_h3.parquet) | 292 MB | Wide format with H3 spatial indices for globe visualizations |
4848
| [Facet summaries](https://data.isamples.org/isamples_202601_facet_summaries.parquet) | 2 KB | Pre-computed filter counts — loads instantly |
4949
| [H3 clusters (res4)](https://data.isamples.org/isamples_202601_h3_summary_res4.parquet) | 0.6 MB | Zoomed-out globe view |

0 commit comments

Comments
 (0)