Skip to content

Commit aac251d

Browse files
committed
[docs] define five-board tutorial evidence
Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
1 parent e7eb5e1 commit aac251d

1 file changed

Lines changed: 34 additions & 0 deletions

File tree

‎docs/specifications/website.md‎

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -369,6 +369,40 @@ Each published app capture MUST:
369369
- leave every app pixel truthful: no retouching, generative fill, fabricated
370370
state, or removal of an in-app warning, error, or identity.
371371

372+
The reviewed five-board Android capture set MUST use only the physical Lenovo
373+
TB-J616X and MUST keep the following evidence boundaries explicit:
374+
375+
- discovery uses a stopped, stable scan with exactly five distinct
376+
`PyBLE-XXXX` advertisements and `Scan: Idle`; an advertisement proves only a
377+
nearby PBLE agent, not its provisioning profile;
378+
- each connected identity is represented by two deterministic crops from the
379+
same raw frame: the Ready status containing board ID and agent version, and
380+
the read-only runtime-chip panel. The crops MAY be paired only through
381+
semantic HTML/CSS; they MUST NOT be baked into an annotated or retouched
382+
raster composite;
383+
- the connected set records the observed pairs `5646` / `esp32-s3`, `8C9E` /
384+
`esp32`, `C81A` / `esp32-c3`, `DA86` / `esp32-s3`, and `3DCB` /
385+
`rpi-pico2-w`. These are documentation-session observations, not release
386+
qualification or proof of installed profile bytes;
387+
- the two ESP32-S3 observations MUST remain visibly indistinguishable at the
388+
runtime-token layer. A maintainer's physical-board or installer record MAY
389+
identify one of those sessions separately, but the app image MUST NOT be
390+
cited as proof of either `esp32-s3-n16r8` or
391+
`waveshare-esp32-s3-lcd-147b`; and
392+
- full-frame workflow captures MUST show only the intentional disposable
393+
tutorial state. Connected-identity derivatives MUST crop out unrelated board
394+
file lists rather than publish or retouch them.
395+
396+
The Setup tutorial MUST use the stable five-board discovery frame and all five
397+
paired identity observations. The Hardware safety tutorial MUST use the same
398+
identity set specifically to teach the difference between a runtime token and
399+
an exact profile. Configured hardware, Pico 2 W, and Waveshare tutorials MAY
400+
reuse only the identity observations that add that same boundary evidence;
401+
their existing physical or authored visuals remain necessary for exact-board,
402+
pin, and wiring instruction. The six app-workflow tutorials MUST otherwise use
403+
their clean, task-specific Lenovo captures; repeating an identity crop as
404+
decoration does not satisfy their visual requirement.
405+
372406
Debug, integration-test, simulator, emulator, and golden-renderer frames MUST
373407
NOT be presented as physical-device captures. A debug or integration-test
374408
label disqualifies the frame from public tutorial use even when the underlying

0 commit comments

Comments
 (0)