R18.8: Document language attribute

Short answer: Html root element specifies valid lang=’en’ attribute. Without a language, a screen reader reads the page in the wrong voice.

Group: Accessibility (WCAG 2.1 AA). Status: stable. Generated from the rule definitions; do not edit by hand.

Playground: https://brevio.pro/tools/agent-guard-playground?rule=R18.8

What it catches

Document language attribute: html root element specifies valid lang=’en’ attribute.

Why

Without a language, a screen reader reads the page in the wrong voice.

A bad example

<html>

A good example

<html lang="en">

How it is checked

Nothing yet. No scanner and no slice card checks it: it is a standing rule for authors and reviewers.

How to silence it

A person can silence one finding with brevio-core: ignore R18.8 -- reason on the line or the line above. Without the reason it does not count. An agent cannot silence it: the agent hook and the MCP tools never honour the comment, and a pull request that adds one is reported until a reviewer allows it. Fixing the code is still the better answer.

To change what the rule flags, edit its definition in dev_rules.py or code_rules/__init__.py. That is a code change and is reviewed like one.

R18.1 Meaningful image alternative text
R18.2 Form control labels
R18.3 Keyboard navigation accessibility
R18.4 Contrast ratio minimum
Every rule