seo/single-h1
Every page has exactly one <h1>. Reglen seo/single-h1 kører i page-scope med severity 'error' og indgår i teknisk seo-domænet sammen med 23 andre kontrakter i frameworket.
Hvorfor single-h1 findes
One <h1> per page gives search engines and assistive tech an unambiguous topic statement. Zero h1s leaves the topic undeclared; multiple h1s dilute it.
Sådan håndhæves single-h1
Reglen single-h1 evalueres på hver enkelt renderet HTML-side for sig, så et fund altid kan føres tilbage til én konkret side og én konkret rettelse i data eller template. Fejler en side, får agenten en finding, hvor fix-instruktionen for single-h1 er formuleret som en konkret arbejdsordre med filnavne og målbare krav — aldrig et vagt råd. Severity 'error' betyder at et brud på single-h1 fejler hele verifikationen med exit-kode 1, så hverken CI eller en agent kan skibe sitet før fundet er rettet.
Domænet: teknisk seo
Reglerne i seo-domænet dækker det klassiske tekniske fundament: titler, beskrivelser, canonicals, struktureret data, sitemaps og URL-hygiejne. Det er her de fleste sites taber terræn — ikke på avancerede tricks, men på basale signaler der mangler eller modsiger hinanden på tværs af tusindvis af sider. Netop derfor hører single-h1 hjemme her: kravet kan afgøres maskinelt, og dermed kan det håndhæves i stedet for blot at blive anbefalet.
Test og fixtures
Som alle kontrakter i frameworket har seo/single-h1 en mutant-test, der beviser at reglen fejler, når kravet brydes — en regel uden en fejlende test er ikke en regel. Golden-fixturet beviser omvendt, at en fuldt compliant side består single-h1 sammen med de øvrige 85 regler, og denne demoside er selv underlagt hele kontrakten.
Relaterede regler
Tilbage til oversigten over alle 86 regler.