docs: Why H3 rationale page + iSamples Explorer layout/code-display cleanup

_quarto.yml

@@ -44,6 +44,8 @@ website:
             href: models/index.qmd
           - text: "Technical: Narrow vs Wide"
             href: tutorials/narrow_vs_wide_performance.qmd
+          - text: "Technical: Why H3?"
+            href: tutorials/why_h3.qmd
       - text: "Research & Resources"
         menu:
           - text: "Publications & Conferences"
@@ -97,6 +99,8 @@ website:
           text: Vocabularies
         - text: "Technical: Narrow vs Wide"
           href: tutorials/narrow_vs_wide_performance.qmd
+        - text: "Technical: Why H3?"
+          href: tutorials/why_h3.qmd
     - id: research
       title: "Research & Resources"
       style: "docked"

data.qmd

@@ -149,6 +149,8 @@ con.sql("""
 
 The H3 summary files back a progressive-globe rendering pattern:
 render aggregate circles at low zoom, individual points at high zoom.
+For why we use H3 at all and why specifically resolutions 4 / 6 / 8,
+see [Technical: Why H3?](tutorials/why_h3.qmd).
 Approximate breakpoints:
 
 | Zoom / altitude | Use |

how-to-use.qmd

@@ -96,7 +96,8 @@ and counts instantly, without touching the 278 MB primary file:
 
 Hexagonal H3 cells pre-aggregated at three resolutions for zoom-adaptive
 globe rendering. Each row: `h3_cell, center_lat, center_lng, sample_count,
-dominant_source, source_count`.
+dominant_source, source_count`. For the design rationale (why hexagons,
+why these resolutions), see [Technical: Why H3?](tutorials/why_h3.qmd).
 
 | File | Size | Cells | Typical altitude |
 |---|---:|---:|---|