docs(work): map html examples navigation slices

Add a northstar and ready vertical slices for making html_examples start at an index, splitting implemented examples into focused pages, proving infinite-scroll by scrolling, and keeping smoke/docs/requirements aligned.
2026-06-26 08:18:21 +02:00
parent 379ed02f88
commit 9dd8e4a944
6 changed files with 343 additions and 0 deletions
@@ -0,0 +1,55 @@
+---
+id: SLICE-0016
+type: slice
+status: ready
+parent: NS-0004
+title: Update html_examples smoke and README for index/page navigation
+refs:
+  - AGENTS.md
+  - REQUIREMENTS.md
+  - examples/html_examples/README.md
+  - examples/html_examples/src/main.rs
+  - hemx-xtask/src/main.rs
+---
+
+## Objective
+
+Keep the public documentation and focused browser smoke aligned with the new html_examples structure so contributors can trust `/` as an index, focused pages as copyable examples, and `infinite-scroll` as a scroll-triggered interaction.
+
+## Authority
+
+- `AGENTS.md` identifies `cargo run -p hemx-xtask -- html-examples-smoke` as the focused repo-owned browser verification for the HTML pattern gallery and no-reload dynamic interactions. req: test/006 req: test/013 req: test/014
+- `examples/html_examples/README.md` is the public run command and pattern matrix.
+- `hemx-xtask/src/main.rs` owns smoke scripts, diagnostics, and no-navigation/no-reload guards.
+
+## Close when
+
+- `examples/html_examples/README.md` still explains the run command and pattern matrix, but its proof anchors and navigation notes match the new index/per-page structure.
+- `cargo run -p hemx-xtask -- html-examples-smoke` starts from the index, follows real example links/routes, and proves representative no-reload dynamic behavior on focused pages.
+- The smoke includes a scroll-based infinite-scroll proof and keeps the existing no-navigation/no-reload guard for dynamic interactions.
+- Smoke failures identify the named example route/path so a broken page split is easy to diagnose.
+
+## Allowed files
+
+- `examples/html_examples/README.md`
+- `hemx-xtask/src/main.rs`
+- `examples/html_examples/src/main.rs` only for testability hooks or route names already owned by implementation slices
+- `REQUIREMENTS.md` only if smoke/documentation duties become durable requirements
+- `AGENTS.md` only if the stable command guidance must change; otherwise do not touch it
+
+## Verification
+
+- `cargo test -p hemx-xtask`
+- `cargo run -p hemx-xtask -- html-examples-smoke`
+- `cargo test -p hemx-html-examples` if route names/templates changed in the same slice
+- `redgate health --strict && redgate lint` if `REQUIREMENTS.md` or `AGENTS.md` changes
+
+## Non-goals
+
+- Do not add a second smoke runner, Playwright/Selenium dependency, `/tmp` smoke scripts, or untracked proof files.
+- Do not use smoke updates to implement new examples.
+- Do not weaken existing dynamic checks for click-to-edit, edit-row, validation, search, lazy-load, click-to-load, progress, value-select, reset, or revealed fallback.
+
+## Evidence
+
+Ready; no implementation evidence yet.