From fc2771b6cf264473de47a76f1975fa5618f06baa Mon Sep 17 00:00:00 2001 From: Will Manning Date: Tue, 10 Nov 2026 17:53:17 -0500 Subject: [PATCH 01/10] Add an FAQ page, with FAQPage structured data /faq answers the questions people ask search engines and AI assistants about Vortex: what it is, how it compares to Parquet, when to use it, why it is fast, whether the format is stable, how to install it, who uses it, who maintains it, and where to get help. The comparison with Parquet carries the homepage's figures from bench, and the adopters and install commands come from the homepage's own lists, so the page cannot fall behind them. The page draws the design system's Article card, as a blog post does. The footer links to it on both sites, the sitemap lists it, llms.txt links it, and llms-full.txt gives it in full. verify checks that its FAQPage data has one question per heading, and the axe run covers it. Signed-off-by: Will Manning --- scripts/verify.ts | 21 ++- src/app/(site)/faq/opengraph-image.tsx | 16 ++ src/app/(site)/faq/page.tsx | 98 +++++++++++++ src/app/(site)/llms-full.txt/route.ts | 5 +- src/app/(site)/sitemap.ts | 15 +- src/components/layout/footer.tsx | 4 +- src/lib/faq.ts | 193 +++++++++++++++++++++++++ src/lib/llms.ts | 13 +- tests/a11y.spec.ts | 2 +- tests/unit/faq.test.ts | 124 ++++++++++++++++ 10 files changed, 480 insertions(+), 11 deletions(-) create mode 100644 src/app/(site)/faq/opengraph-image.tsx create mode 100644 src/app/(site)/faq/page.tsx create mode 100644 src/lib/faq.ts create mode 100644 tests/unit/faq.test.ts diff --git a/scripts/verify.ts b/scripts/verify.ts index 6dde040b..c80f5981 100644 --- a/scripts/verify.ts +++ b/scripts/verify.ts @@ -167,7 +167,7 @@ async function checkSitemap(): Promise { const locs = [...r.body.matchAll(/([^<]+)<\/loc>/g)].flatMap((m) => m[1] ? [m[1]] : [] ); - const required = ["/", "/blog"]; + const required = ["/", "/blog", "/faq"]; const paths = locs.map((l) => l.replace(/^https?:\/\/[^/]+/, "") || "/"); const missing = required.filter((p) => !paths.includes(p)); if (missing.length > 0) { @@ -326,6 +326,25 @@ async function checkRoute( } } + // FAQPage schema on /faq, with one Question per heading + if (path === "/faq") { + const ld = jsonLd(r.body); + const faq = ld.ok + ? ld.blocks.find((b) => b["@type"] === "FAQPage") + : undefined; + const questions = Array.isArray(faq?.mainEntity) + ? faq.mainEntity.length + : 0; + const headings = (r.body.match(/ +