OSS-first docs

These docs teach the open system first: contracts, generated surfaces, runtimes, governance, and incremental adoption. Studio shows up as the operating layer on top, not as the source of truth.

AI index

Presentations Conventions (A11y & i18n)

  • Always provide meta.description (≥ 3 chars) — used by a11y/docs/agents.
    • field.key.label
    Presentations Conventions (A11y & i18n)
    field.version.label
    field.type.label
    field.title.label
    Presentations Conventions (A11y & i18n)
    field.description.label
  • Always provide meta.description (≥ 3 chars) — used by a11y/docs/agents.
    • field.tags.label
    tech,contracts,presentations-conventions
    field.owners.label
    field.stability.label
    public

    Presentations Conventions (A11y & i18n)

    •

    Always provide `meta.description` (≥ 3 chars) — used by a11y/docs/agents.

    •

    Prefer source = BlockNote for rich guides; use component key for interactive flows.

    •

    i18n strings belong in host apps; descriptors carry keys/defaults only.

    •

    Target selection: include only what you intend to support to avoid drift.

    •

    PII: declare JSON-like paths under `policy.pii`; engine redacts in outputs.