AI crawlers use heading text as the primary signal of what a page section covers — headings like "Features," "Benefits," "Overview," and "Resources" convey zero topical information and provide no basis for the model to retrieve that section when answering a related query. Descriptive headings with product-specific nouns are what anchor a section in the model's topical map and get it cited.
High because generic headings strip topical context that AI systems rely on for section-level retrieval.
Replace generic single-word headings with descriptive phrases of at least four words that include a product-specific or domain-specific noun. Edit H2 and H3 tags across marketing pages and content routes. Update src/app/page.tsx, pricing, and feature page files.
<h2>What the Security Headers Audit Checks</h2>
<h2>Why Audit Your AI-Built Project</h2>
<h3>Run Your First Audit in 3 Minutes</h3>
ID: geo-readiness.ai-readable-structure.descriptive-headings
Severity: high
What to look for: Count all H2 and H3 headings on marketing and content pages. Classify each heading as "descriptive" or "generic." Generic headings are labels that could appear on any website with no modification: "Features", "About", "More", "Info", "Overview", "Details", "Resources", "Benefits", "Solutions", "Services", "Products", "Getting Started", "Learn More", "Why Us", "Our Story". Descriptive headings contain a noun specific to the product or domain: "How AuditBuffet Scores Your Project", "Community Audit Benchmarks", "Run Your First Security Audit". Enumerate each heading with its classification.
Pass criteria: Count all H2/H3 headings on marketing and content pages. More than 50% must be descriptive — containing a noun specific to the product, domain, or page topic, not just a generic label. Report: "X of Y headings are descriptive (Z%) — threshold: >50%". A heading with at least 4 words that includes a product-specific or domain-specific noun qualifies as descriptive.
Fail criteria: 50% or more of H2/H3 headings are generic labels from the list above. A homepage with headings like "Features", "Benefits", "Testimonials", "Pricing", "FAQ" is all generic (0% descriptive). Report: "Only X of Y headings are descriptive — Z% (threshold: >50%)".
Skip (N/A) when: No content pages with headings (API-only project).
Detail on fail: "Only 3 of 10 H2/H3 headings are descriptive (30%) — threshold is >50%. Generic headings found: 'Features', 'Benefits', 'About', 'Pricing', 'FAQ', 'Resources', 'Solutions'. AI systems use headings to understand page structure — generic labels provide no topic signal." or "0 of 6 headings are descriptive — all are single generic words with no product or domain terms"
Remediation: AI systems use headings to understand what a page covers. Replace generic labels with descriptive headings in your page components (e.g. src/app/page.tsx):
{/* Bad: generic label */}
<h2>Features</h2>
{/* Good: descriptive, domain-specific */}
<h2>What the Security Headers Audit Checks</h2>
Instead of: "Benefits" → "Why Audit Your AI-Built Project" Instead of: "Getting Started" → "Run Your First Audit in 3 Minutes"
Each heading should tell the reader (and AI) what the section specifically covers.