no question headings

info no-question-headings AI search and answer extraction

AI search retrieves passages, not pages, and a heading phrased as a question is the clearest boundary a passage can have. This is the cheapest structural change with a direct effect on being quoted.

What indexgap reports

The finding reads:

info  no-question-headings  … of … subheadings are questions — the “question → answer” shape is quoted noticeably more often

How to fix it

Reword some of the subheadings as questions: the question → answer shape is quoted noticeably more often.

How it behaves at scale

Collapsed when it fires template-wide. If it appears on 90% or more of the pages — or of one language version — of a site with at least 20 pages, it is a property of the template and is reported once, with the count, instead of once per page.

Finding it

pipx install indexgap
cd your-project
indexgap init
indexgap check

Then indexgap brief turns every finding on this page into a work order in indexgap-briefs/, with the thresholds the result has to satisfy and the command to check it.

Related checks in ai search and answer extraction

All checks · AI search and answer extraction