seo: finality content cluster on l1-finality#84
Merged
Conversation
…inality) GSC shows /benchmarks/l1-finality at 144 imp/wk and 0.69% CTR. The page already ranks (#3 on top query) but the SERP snippet doesn't convert and there's no on-page anchor for the family of 'X chain finality time' queries. Changes: Schema + type plumbing - New optional YAML field per_chain_explainer: array of {slug, h2, body} - Body strings go through the existing template resolver so {{p50:slug}} resolves to live Prom data - Plumbed through spec-schema.ts -> Benchmark type -> spec.ts loader -> bench-template.ts renderer Component update (ChainHeadingsSummary) - Headings upgraded from h3 to h2 (stronger SEO signal) - Each chain section gets id={slug} so URLs like /benchmarks/l1-finality#ethereum land at the exact section - When per_chain_explainer has an entry for the chain's slug, render its body as a second paragraph below the live p50 line - Backward-compatible: chains without an explainer keep the existing 1-line rendering YAML content (l1-finality.yml) - 12 per_chain_explainer blocks (ethereum, solana, stellar, hedera, sui, ton, bnb, avalanche, tron, cardano, litecoin, monero) at 70-90 words each - FAQ expanded from 6 to 12 entries (cap), adding 'What is blockchain finality?', 'Probabilistic vs deterministic finality?', and per-chain entries for SUI, TON, BNB, Cardano (previously missing) Targets these GSC query patterns: - ethereum l1 time to finality (10 imp/wk, position 3.2) - stellar finality time (7 imp/wk, position 6.57) - hedera consensus finality time (4 imp/wk, position 7) - ethereum l1 finality time epochs (1 imp/wk, position 3) - solana finality time (1 imp/wk, position 50) - hedera finality 3-5 seconds (1 imp/wk, position 12) - 8 untapped queries (sui/ton/bnb/avalanche/cardano/tron/litecoin/monero finality time) Estimated impact: 144 imp/wk -> 350-500, position ~5 -> ~3, CTR 0.69% -> 4-6%, clicks 1/wk -> 15-30/wk in 4 weeks. pnpm validate -> 18 specs valid. pnpm typecheck -> clean.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Résumé
Enrich
/benchmarks/l1-finalityto capture the family of 'X chain finality time' queries currently leaking impressions without converting.GSC data: page sits at 144 impressions/wk but 0.69% CTR. Ranks #3 on the dominant query ('ethereum l1 time to finality') but the SERP snippet and the page layout don't promise specific numbers per chain.
Changes
Schema + type plumbing
per_chain_explainerYAML field: array of{slug, h2, body}{{p50:slug}}etc. resolve to live Prom dataspec-schema.ts->Benchmarktype ->spec.tsloader ->bench-template.tsrendererComponent update (
ChainHeadingsSummary)id={slug}so URLs like/benchmarks/l1-finality#ethereumland at the exact sectionYAML content (
l1-finality.yml)Target queries (from GSC)
#ethereumH2 + FAQ#stellarH2#hederaH2 + FAQ#hederabody#ethereumbody#solanaH2 + FAQ#hederaH2 contains exact stringPlus 8 untapped chains (sui/ton/bnb/avalanche/cardano/tron/litecoin/monero finality time) that now have dedicated H2 anchors.
Estimated impact (per agent #3 plan)
Validation
Notes
{{p50:slug}}templating against live Prom data.