Skip to content
Marcos Caceres edited this page Mar 28, 2026 · 16 revisions

<section id="conformance">

A <section> with id="conformance" tells ReSpec to insert the standard RFC 2119 conformance boilerplate. Add any spec-specific conformance text after the placeholder — ReSpec will prepend the boilerplate above it.

If your spec uses RFC 2119 keywords (MUST, SHOULD, MAY, etc.), you need this section. ReSpec will warn you if RFC 2119 keywords are present but the conformance section is missing:

Warning: Document uses RFC2119 keywords but lacks a conformance section.
Hint: Please add a <section id="conformance">.

Usage

<section id="conformance">
  <p>This specification defines conformance criteria that apply
  to a single product: the <em>widget</em>.</p>
</section>

Suppressing the boilerplate

Add class="override" to take full control and write your own conformance text without any generated boilerplate:

<section id="conformance" class="override">
  <h2>Conformance</h2>
  <p>This document defines requirements for implementations. An implementation
  is conformant if it satisfies all the normative requirements herein.</p>
</section>

Notes

  • Required for specifications that contain normative material (MUST, SHALL, etc.)
  • The boilerplate includes the RFC 2119 keyword definitions ("MUST", "SHOULD", "MAY", etc.)
  • Your custom text follows the boilerplate — it can include additional conformance classes, profiles, or requirements
  • If the section is empty, only the boilerplate is shown
  • class="override" skips all generated content — the section is left exactly as authored

Guides

Configuration options

W3C Configuration options

Linting rules

Internal properties

Handled by ReSpec for you.

Special <section> IDs

HTML elements

Custom Elements

HTML attributes

CSS Classes

Special properties

Clone this wiki locally