Skip to content

Define bounded authoring of the Web Accessibility Standard #17

Description

@jamesreimer

Purpose and authority

Define the bounded authoring action for Web Accessibility Standard, candidate ID web-accessibility, as the first earned companion of the Web Standards Suite.

Parent: #14. Governing planning decision: accepted research and narrowed scope. Supporting research and disposition.

Current authorization is issue creation and scope definition only. Stop before repository-file drafting, catalog expansion, branch creation, commit, or pull request. This issue is not itself permission to implement its proposed file scope. No umbrella or other companion authoring is authorized. Parent #14 remains open.

Reusable problem and normative boundary

Establish a concise, organization-neutral web-accessibility standard that selects a technical target, preserves external conformance semantics, and makes accessibility evidence and claims reviewable. The accepted target is WCAG 2.2 Level AA.

The template should govern web-accessibility outcomes and accessibility-specific verification. It is not a restatement of WCAG, a legal-compliance policy, or a broader inclusive-design standard. Inclusive-use considerations may appear only as clearly identified informative guidance, with no implied complete inclusive-design conformance.

The standard remains independently adoptable. Accessibility is a proposed core suite dependency, but this template must not depend on unfinished companions or umbrella conformance. Ordinary informative links do not create adoption requirements.

Exact proposed future file scope

If separately authorized, use the existing two-file template convention:

Path Proposed change
templates/web-accessibility/standard.md Add the normative Web Accessibility Standard
templates/web-accessibility/README.md Add purpose, boundaries, informative subject-specific adoption review, and legitimate adaptation considerations
CATALOG.md Add only this template's ID, exact title, durable subject, and boundaries, once the template actually exists
repository-structure.txt Regenerate only the deterministic snapshot changes caused by the new directory and two files, using the existing script

All other paths remain excluded, including root README, ADOPTION, naming/maintenance/authoring guidance, tests, validator, automation, and all other templates. No new schema, evidence-file format, tooling, or dependency package. If authoring reveals a necessary change outside these four paths, report it and seek a scope decision instead of expanding implicitly.

Follow CONTRIBUTING.md, MAINTAINING.md, NAMING.md, AGENTS.md, the existing authoring standard, and adjacent README conventions. No repository classification or organizational authority is created by this planning issue.

Source and incorporation research

Anchor the source review to the 12 December 2024 WCAG 2.2 Recommendation and its conformance section.

Review the official errata before drafting and again before proposing publication. Record review date, affected criteria/definitions, source classification, applicability to the dated Recommendation, and the disposition of each relevant change. Identify exactly which source edition and corrections the candidate incorporates; no moving “latest” dependency.

The errata page inspected on 2 September 2026 distinguishes editorial and substantive corrections and says proposed substantive corrections are not normative until a revised Recommendation is published. Its current-publication list includes changes to hover/focus content and definitions. This discovery is not a completed clause-by-clause errata review. Preserve that distinction, and do not silently promote proposals into external requirements.

Incorporation/mapping decisions must:

  • Reference external obligations precisely without copying WCAG or assigning new local numbers to its success criteria.
  • Keep local requirement IDs separate from external identifiers. Pin local version/revision and source edition in evidence references.
  • Distinguish incorporated external requirements from independently justified local requirements, informative Understanding/Techniques/APG guidance, and examples.
  • Produce a reviewable completeness mapping covering the chosen target and conformance conditions, rather than a selected checklist masquerading as full coverage.
  • Preserve source-defined alternatives and exceptions; do not omit inconvenient provisions or broaden exceptions.
  • Recheck relevant HTML/ARIA sources when a local claim actually depends on them, without importing every statement from those sources.

Research mappings and disposition records stay in this issue or later authorized review records unless another artifact is separately justified.

Required authoring decisions

Define, without changing external meanings:

  1. Scope and target: the assessed web experience, artifact/release, pages/routes, states and processes, declared technical target, material exclusions, and boundaries of any assessment.
  2. External conformance: full-page and complete-process treatment, accessibility-supported technology use, non-interference, and applicable conforming-alternate-version provisions.
  3. Claims: distinguish local-standard conformance, WCAG conformance, assessment progress, partial results, and undetermined results. No mandatory public badge or certification scheme. When a WCAG claim is made, preserve its applicable required contents.
  4. Unknowns: missing, stale, inaccessible, or unperformed required checks remain unverified; an automated clean scan is not full conformance.
  5. Exceptions and adaptations: distinguish source-defined exceptions from local waivers or deviations. Organizational permission to depart does not change WCAG's meaning or establish unchanged baseline conformance.
  6. Alternative targets: preserve legitimate independent adoption and stronger obligations. Explain how a different edition/level or weaker local variant changes the claim and mapping; do not label it unchanged WCAG 2.2 AA or unchanged suite-baseline conformance.
  7. Change effects: reassess affected evidence when implementation, scope, source edition, or local requirements change; no automatic downstream mutation.
  8. Inclusive-use information: clearly mark additional considerations and research gaps as informative. Do not mix them into the incorporated WCAG set or imply all user needs are covered.

Calibrate local mandatory requirements, recommendations, and permissions against protected consequences under the authoring standard. Do not add process ceremony merely to make compliance look formal.

Verification responsibilities

Keep accessibility-specific test meaning and results with this standard. Future Quality/Verification may govern shared evidence integrity but must not own duplicate accessibility assertions or become an undeclared prerequisite.

  • Automated: identify repeatable machine-checkable findings, covered rules, artifact/environment/tool versions, and false-positive or coverage limitations.
  • Manual: review keyboard operation, focus behavior, zoom/reflow, state transitions, semantic meaning, alternatives, and source exceptions where human judgment is necessary.
  • Assistive technology: define justified browser/technology combinations and relevant tasks; record actual observations and limitations, not assumed compatibility.
  • Specialist review: identify when complex widgets, media, ambiguous mappings, or limited evaluator expertise require qualified review. Unavailable expertise produces a gap, not a pass.
  • Implementation and review assistance: use the same evidence requirements; distinguish observed, tool-produced, and inferred findings. Neither screenshots nor generated reports prove unperformed interaction or user testing. No live-system/data access is granted.

Plan evidence identifying requirement/source, assessed revision and scope, method/environment, expected/observed result, evaluator/tool, date, and limitations. Avoid a universal storage schema or retention regime.

Pressure-test the candidate against reflow exceptions, pointer-only custom controls, modal focus, semantic relationships, third-party content, incomplete multi-step processes, absent manual evidence, legitimate alternate versions, and adapted targets. Distinguish desk tests from actual browser/assistive-technology tests and pilots.

Informative README adoption review

Reference the universal ADOPTION.md; do not duplicate it or create a separate contributor policy. Add bounded questions about:

  • existing accessibility obligations, targets, authority, stronger protections, and conflicting terminology;
  • covered pages/processes, embedded or third-party content, and legacy constraints;
  • target/source-edition differences and their consequences for claims;
  • migration effects, accessible alternatives, and preservation of existing protection;
  • available automated, manual, assistive-technology, and specialist verification;
  • unresolved evidence, local exceptions, and whether adoption adds durable value;
  • separation of informative inclusive-use guidance from normative requirements.

Keep pre-adoption safety questions distinct from legitimate organization-specific adaptation choices.

Exclusions

No legal certification or legal interpretation; mandatory vendor/tool/framework; organization-specific approval workflow; broader inclusive-design conformance; umbrella or other companion requirements; brand/design-system rules; new records regime; automation; adopter implementation, adoption, synchronization, or mutation.

No catalog addition, repository drafting, branch, commit, or PR in the current issue-definition pass. Creating this issue does not approve eventual text or authorize publication.

Review gates before any drafting

  • Exact title, ID, four-path proposed scope, and independent boundary confirmed.
  • Dated source and relevant errata disposition reviewed; incorporation and mapping approach accepted.
  • Local/external requirement boundaries and conformance/exception/alternative-target handling resolved.
  • Verification responsibilities and unresolved coverage limitations documented.
  • Informative inclusive-use and subject-specific adoption-review boundaries confirmed.
  • A separate bounded drafting instruction is supplied before any repository-file work begins.

For later authorized drafting, run the existing unit tests and repository validator; regenerate the structure snapshot only for the authorized new paths; check Markdown links/anchors, UTF-8/LF, final newline, and git diff --check. Manually verify external claims and normative calibration. Mechanical validation does not establish accessibility conformance.

Current completion boundary: create and link this one child issue, report it, and stop. Keep #14 open; do not start drafting.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions