Registry stack documentation: machine-readable Markdown.
Index of all pages: https://docs.registrystack.org/llms.txt
Full corpus: https://docs.registrystack.org/llms-full.txt

# Accessibility

> Accessibility targets for the Registry Docs documentation site.

Registry Docs targets WCAG 2.1 Level AA conformance
as its accessibility baseline for the v0 launch.
This page records the targets, keyboard navigation approach, and alt-text policy.
Contrast values are calculated from design tokens; an external audit has not been performed
(see [Known limitations](#known-limitations)).

## WCAG target

The site targets WCAG 2.1 Level AA.
All text meets AA contrast ratios against their backgrounds (calculated values; not yet verified by a third-party audit tool).
Blue France `#000091` on white `#ffffff` passes AA for normal text.
Blue France on the active-sidebar tint `#eeeefd` also passes AA for normal text.
Status text uses ink `#161616` on white, at a 21:1 contrast ratio, well past the AA threshold.

{/* TODO[evidence]: WCAG 2.1 AA is stated in the design doc (design-registry-docs.md, Accessibility section).
     No automated contrast-check result has been run against the built site yet.
     Verify with a tool such as axe-core or Colour Contrast Analyser before marking as audited. */}

## Keyboard navigation

The site is keyboard-navigable end to end.
A skip-link is present to bypass repeated navigation.
Focus rings are 2 px Blue France with 2 px offset, square corners.
Browser focus defaults are not suppressed.

The masthead, secondary navigation, sidebar, and footer use semantic HTML landmarks:
`<header>`, `<nav>`, `<aside>`, and `<footer>`.
The content column uses `<main>`.

## Alt text and image policy

Every image has either `alt` text or a visible caption that conveys the essential information
without requiring the image to be visible.
Conceptual diagrams use SVG.
Important labels in a diagram also appear in nearby HTML text,
so machine contracts are not encoded only inside an image.

The site does not use animated GIFs or videos in v0.

## Search

The search input has a visible label.
The placeholder text is not a substitute for a label.

## Known limitations

- The v0 site has not yet undergone an external WCAG audit.
- French routes are not enabled in v0.
  When French content is added, translated `alt` text and landmark labels will be required.