---
title: "Accessibility Statement"
slug: "accessibility"
category: "meta"
tags: ["meta", "accessibility", "wcag", "policy"]
status: "stable"
last_updated: 2026-07-30
summary: "Conformance target, testing process, known limitations, and how to report an accessibility issue on llmbestpractices.com."
related: ["[[meta/about]]", "[[meta/privacy]]", "[[frontend/accessibility]]", "[[howto/run-pa11y-locally]]", "[[meta/changelog]]"]
---

## Overview

This is the accessibility statement for `llmbestpractices.com`. It covers the standard the site targets, how conformance is tested, what is not yet fixed, and how to report a problem.

## Conformance target

The site targets WCAG 2.2 Level AA across every page. This is a target, not a certified conformance claim; no page has been audited by a third-party accessibility specialist.

## How conformance is tested

- `pa11y-ci` runs against a sample of routes, home, category MOCs, a tag page, deep content pages, and the 404 page, on every pull request, checked against WCAG2AA.
- Lighthouse CI scores the accessibility category on every pull request. The gate is currently a warning, not a hard failure, while the last few points close.
- Manual passes: keyboard-only navigation and a screen reader spot-check on major layout changes.

Automated tools catch roughly 30 to 40 percent of WCAG failures. See [[frontend/accessibility]] for the checklist this site builds against, and [[howto/run-pa11y-locally]] for running the same audit locally.

## Known limitations

- Measured Lighthouse accessibility score sits below the 100 target; the CI gate moves from `warn` to `error` once it clears cleanly and consistently.
- A small number of heavy content pages can exceed pa11y-ci's navigation timeout under CI load and are excluded from the automated route sample. This is a load-time workaround, not an accessibility exemption.
- No conformance audit has been performed by an outside accessibility specialist. The self-testing described above is the only verification in place today.

This list is updated as issues are found and fixed; see [[meta/changelog]] for the dated log of site changes.

## Reporting a problem

This site has no contact form or comment system; see [[meta/privacy]] for why. Report an accessibility barrier by opening an issue at [`github.com/AXIA-Enterprises/llmbestpractices/issues`](https://github.com/AXIA-Enterprises/llmbestpractices/issues). Include the page URL, the browser or assistive technology you used, and what you expected to happen.

## Related

- [[meta/about]]
- [[meta/privacy]]
- [[frontend/accessibility]]
- [[howto/run-pa11y-locally]]
- [[meta/changelog]]