Skip to content

fix(compare): sync visible FAQ with FAQPage schema + guard against drift - #89

Merged
shainova merged 1 commit into
mainfrom
fix/faq-schema-sync
Aug 31, 2026
Merged

shainova merged 1 commit into
mainfrom
fix/faq-schema-sync

Conversation

@shainova

Copy link
Copy Markdown
Member

The FAQ lives twice on compare.html — as visible

Details markup and as a FAQPage JSON-LD block — and Google requires the schema to reflect the visible page. The two had drifted: the improved "What is a multilayer network?" definition was added to the schema only.

  • Propagate that definition to the visible answer; align three smaller differences (en-dashes, "&" vs "and", and the emln clause).
  • Add tests/faqSchema.test.js: verifies the JSON-LD parses, a FAQPage block exists, and every question title and answer matches the visible text. Verified to fail on injected drift.

The FAQ lives twice on compare.html — as visible <details> markup and as a
FAQPage JSON-LD block — and Google requires the schema to reflect the visible
page. The two had drifted: the improved "What is a multilayer network?"
definition was added to the schema only.

- Propagate that definition to the visible answer; align three smaller
  differences (en-dashes, "&" vs "and", and the emln clause).
- Add tests/faqSchema.test.js: verifies the JSON-LD parses, a FAQPage block
  exists, and every question title and answer matches the visible text.
  Verified to fail on injected drift.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@shainova
shainova merged commit 88d6e0f into main Aug 31, 2026
3 checks passed
@shainova
shainova deleted the fix/faq-schema-sync branch August 31, 2026 15:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant