From b5e8b94e57ef823176f89e5d8a3b52938fe2c58b Mon Sep 17 00:00:00 2001 From: vyctorbrzezowski Date: Sat, 8 Aug 2026 16:32:54 -0300 Subject: [PATCH] docs: use preview build for visual proof --- scripts/docs-site/AGENTS.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/scripts/docs-site/AGENTS.md b/scripts/docs-site/AGENTS.md index 162b451b7f..34a2f40e5c 100644 --- a/scripts/docs-site/AGENTS.md +++ b/scripts/docs-site/AGENTS.md @@ -6,6 +6,7 @@ Scope: docs shell generator, hidden visual fixtures, local smoke checks, and R2 - Keep authored docs under `docs/**` out of this subtree. Use virtual fixtures or generator code here when testing shell UI. - The hidden component fixture is generated at `/__elements`; keep it `noindex` and out of `sitemap.xml` and `llms.txt`. - Run `make docs-check` after renderer, shell CSS, visual fixture, asset, or smoke changes. -- Use `make docs-elements` to build and smoke the hidden fixture, then `make docs-serve` plus `make docs-elements-open` for visual review. +- For visual proof, run `DOCS_SITE_PREVIEW_INCLUDE_FIXTURE=1 npm run docs:build:preview`; do not rebuild the full locale corpus just to capture screenshots. +- After the preview build, use `make docs-serve` plus `make docs-elements-open` for visual review. - Add smoke coverage in `scripts/docs-site/smoke.mjs` for any new visual contract that would be annoying to catch by eye later. - Keep R2 uploads diff-friendly: no generated timestamp churn, randomized output, or broad rewrites unless the source docs changed.