docs: Why H3 rationale page + iSamples Explorer layout/code-display cleanup#152
Merged
rdhyee merged 3 commits intoisamplesorg:mainfrom Apr 30, 2026
Merged
docs: Why H3 rationale page + iSamples Explorer layout/code-display cleanup#152rdhyee merged 3 commits intoisamplesorg:mainfrom
rdhyee merged 3 commits intoisamplesorg:mainfrom
Conversation
H3 has no standalone Wikipedia article, so newcomers landing on the iSamples site lack a fallback for understanding the choice. This page documents why H3 over square grids and over S2/geohash, why resolutions 4/6/8 specifically (cell size × altitude band × parquet size budget), and what we'd revisit (dominant-source-per-cell color encoding). - New page: tutorials/why_h3.qmd - Wired into navbar + sidebar under "Architecture & Vocabularies" alongside the existing "Technical: Narrow vs Wide" doc - Cross-linked from data.qmd §4 and how-to-use.qmd's H3 section Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Contributor
Author
|
Review finding: the new Why H3 page says the wide parquet carries The H3 columns are in Checks I ran:
|
Replaces code-fold with echo: false at the format level so source code blocks no longer appear at all (previously shown behind a "Code" toggle that took visual space). Removes per-cell //| code-fold directives that were overriding the format setting, and drops the now-empty "Setup" and "Database & Queries" section headings (their cells produced no rendered output). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Move the Cesium globe into the right column of the filters grid so it's visible immediately (was below the fold under its own ## Globe View heading). Drop the viewMode radio (globe / list / table) — globe is now always visible top-right and the results table renders full width below the grid as ### Results. Removes the now-unused list view, viewMode-keyed display toggles on the cesiumContainer/legend, and the v2-only deferred-mount branch in the viewer cell. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This PR bundles three unrelated cleanups on the same branch:
1. Why H3? rationale page (
tutorials/why_h3.qmd)Documents why iSamples uses H3 — and why resolutions 4/6/8 specifically — so newcomers don't have to reverse-engineer the choice from the H3 tier files. Motivated by Raymond's observation that H3 has no standalone Wikipedia article, only a mention in Discrete global grid. Without that fallback, the site needs to make the design choice legible itself.
What the page covers:
h3_res6column)Wiring:
data.qmd §4(the H3 tier breakpoints table) and fromhow-to-use.qmd's H3 helpers section2. Explorer: hide all OJS code (
tutorials/isamples_explorer.qmd)Replaces
code-fold: truewithecho: falseat the format level so source code blocks no longer appear at all (previously shown behind a "Code" toggle that took visual space). Removes per-cell//| code-folddirectives that were overriding the format setting, and drops the now-empty "Setup" and "Database & Queries" section headings (their cells produced no rendered output).3. Explorer: layout A — globe in right column, table full-width
Moves the Cesium globe into the right column of the filters grid so it's visible immediately (was below the fold under its own
## Globe Viewheading). Drops the viewMode radio (globe / list / table) — globe is now always visible top-right and the results table renders full width below the grid as### Results. Removes the now-unused list view, viewMode-keyed display toggles on the cesiumContainer/legend, and the v2-only deferred-mount branch in the viewer cell.Test plan
quarto render tutorials/why_h3.qmdsucceedsquarto render data.qmdandquarto render how-to-use.qmdsucceed (cross-link renders correctly)#h3-tier-breakpoints-for-map-authorsexists indocs/data.html(target of the back-link from why_h3)quarto render tutorials/isamples_explorer.qmdsucceeds; rendered HTML has zero visible code blocks; H2 sections are Search & Filters → Sample Card → Debug Info; cesiumContainer renders inside the Search & Filters grid right column; full-width results table appears below🤖 Generated with Claude Code