Skip to content

docs: state the schema's user-facing guarantees (exact-path errors, http(s)-only URLs) - #537

Merged
ChristianLuciani merged 1 commit into
mainfrom
vibe/docs-validation-copy-4c8e04
Nov 14, 2026
Merged

ChristianLuciani merged 1 commit into
mainfrom
vibe/docs-validation-copy-4c8e04

Conversation

@ChristianLuciani

Copy link
Copy Markdown
Owner

Summary

  • site/index.html + site/es/index.html (card 01): one line added — schema violations fail with the exact path; URLs are http(s)-only, so a javascript: link can't reach a published profile.
  • docs/USER-GUIDE.md §4.3: three-line note on what the contract guarantees beyond shape — http(s)-only URLs, unknown files/keys fail instead of being ignored, load() refuses duplicate ids and dangling cross-references.
  • Copy only; no behavior change. Docs stay in English per D8; the ES landing mirrors the EN one.

Verification

  • pnpm site → site-check PASS (11 pages, 248 ids, 527 links), version-check PASS
  • node scripts/link-check/check.mjs --check → PASS (79 files, 317 links)
  • node scripts/agnostic-check/check.mjs → PASS (0 private references)

…er guide

Validation benefits in one line each: schema violations fail with the
exact path, URLs are http(s)-only (a javascript: link never reaches a
published profile), and load() refuses duplicate ids / dangling refs.

Signed-off-by: Vibe Nuage Agent <vibe@mistral.ai>

Co-authored-by: ChristianLuciani <ChristianLuciani@users.noreply.github.com>
@ChristianLuciani
ChristianLuciani marked this pull request as ready for review November 14, 2026 19:06
@ChristianLuciani
ChristianLuciani merged commit d8178b1 into main Nov 14, 2026
3 checks passed
@ChristianLuciani
ChristianLuciani deleted the vibe/docs-validation-copy-4c8e04 branch November 14, 2026 19:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants