---
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.