Skip to content

V1 Docs Full SEO Overhaul: metadata, content expansion, internal linking & deprecation notices#37

Merged
divyasshree-BQ merged 14 commits intomainfrom
feat/v1-full-seo-improvements
Apr 2, 2026
Merged

V1 Docs Full SEO Overhaul: metadata, content expansion, internal linking & deprecation notices#37
divyasshree-BQ merged 14 commits intomainfrom
feat/v1-full-seo-improvements

Conversation

@buddies2705
Copy link
Copy Markdown
Contributor

@buddies2705 buddies2705 commented Apr 1, 2026 •
edited
Loading

Summary

Comprehensive SEO improvement across the entire V1 documentation site (399 files changed, 6875 insertions).

What's included

Phase 1 — Foundation

  • Expanded Coinpath Explained docs with SEO metadata, worked examples, and cross-links
  • Full V1 docs SEO pass: metadata, keywords, and cross-links for 370+ pages
  • Fixed duplicate meta tags, broken URLs, and inaccurate descriptions
  • Added redirect for Bitcoin examples hub casing mismatch
  • Improved query headings across 67 Example pages for SEO
  • Added front matter to 15 .mdx files, rewrote 55 generic Schema descriptions, fixed Dogecoin duplicate title

Phase 2 — Content expansion

  • Expanded 31 thin high-impact Schema pages with queryable fields and use-case guidance
  • Expanded 40 additional thin Schema detail pages (address, addressStats, balance, blocks, coinpath, activeAddresses, mints, instructions, messages, arguments, effectArguments)
  • Added enterprise-related use cases to 18 active chain overview pages

Phase 3 — Queries & linking

  • Added example GraphQL queries to 10 coinpath Schema pages (Ethereum, BSC, Cronos, Bitcoin, Dash, Dogecoin, Algorand, Celo, Cosmos, Tron)
  • Fixed 9 self-referencing links in coinpath Related Resources sections
  • Added Examples links to 7 Schema overview pages
  • Added Related Resources with Schema backlinks to 9 Example pages
  • Improved internal linking on 8+ guide pages (graphql-ide, building-queries, fund tracking)

Deprecation notices

  • Harmony, Tezos, Elrond, Conflux, EOS, Velas, Ethereum Beacon Chain, Hedera, Flow — all marked as deprecated with :::caution admonitions on overview and detail pages

Test plan

  • yarn build compiles successfully with zero errors
  • Verified no existing content was accidentally removed
  • Verified all self-referencing links removed
  • Verified URL patterns are consistent (/v1/docs/...)
  • Verified deprecated chain pages have notices and no new content was added
  • Spot-check rendered pages on staging for correct heading hierarchy and link targets
  • Verify redirects work (Bitcoin examples casing)

Gaurav agarwal added 11 commits April 1, 2026 21:32
Expand Coinpath Explained docs: SEO metadata, worked examples, cross-…
77f63a1 
…links

- Overview: added intro, use-cases table, chain-type comparison, navigation
- How to Read: added intro summary, Next Steps footer with cross-links
- EVM: added LRFS worked example, supported networks, Ethereum query
- UTXO: added proportional attribution table, change output section, Bitcoin query
- Ledger-Based: expanded 4 challenge sections, comparison table
- All pages: SEO front matter (title, description, keywords), cross-links

Made-with: Cursor
Full V1 docs SEO: metadata, keywords, and cross-links for 370+ pages
32db7b2 
- Added front matter title, description, keywords to all pages missing SEO
- Added <head> meta blocks (title, description, keywords, robots, OG, Twitter)
- Added Related Resources cross-links using production URLs across all pages
- Schema: all 24 chain overviews + ~250 detail pages (bitcoin, ethereum, polygon,
  BSC, tron, ripple, solana, avalanche, and 16 more chains)
- Examples: 65 example pages across bitcoin, ethereum, solana, tron, cosmos, etc.
- Core: intro, graphql-ide (10 pages), building-queries (3), query-features (16)
- Use-Cases (5), API-Blog (1), Examples overview
- Build verified: yarn build passes cleanly

Made-with: Cursor
Fix SEO quality issues: duplicate meta, broken URLs, inaccurate descr…
277d27a 
…iptions

- Removed duplicate <head> blocks from 273 newly-added pages (keep front matter
  as single source of truth; Docusaurus generates title/description/OG/Twitter)
- Fixed broken Bitcoin example hub URLs (Examples/bitcoin → examples/Bitcoin)
- Fixed space-in-URL on addressstats.md
- Fixed inaccurate descriptions: Bitcoin overview (removed "smart contracts"),
  ethereum2 (Beacon Chain specifics), Bitcoin transactions (UTXO-specific)
- Fixed copy-paste errors: Bitcoin-Blocks-API "Cosmos" → "Bitcoin",
  tron transfers "rpovides", ethereum transactions "exmaple", intro "Bitquery 's",
  basic-structure "Architechture"
- Cleaned keyword spam on bitcoin/ethereum coinpath meta tags
- Added SEO to missed pages: multi-chain-portfolio-tracker, tezos/harmony overviews

Made-with: Cursor
Add redirect for Bitcoin examples hub casing mismatch
c66c587 
File path is Examples/bitcoin/ but slug is /examples/Bitcoin.
createRedirects handles /docs/Examples/bitcoin/index → /docs/examples/Bitcoin
so old bookmarks and external links to the wrong-cased path still work.

Made-with: Cursor
Improve query headings across 67 Example pages for SEO
cca6fc2 
- Added chain names to generic headings (e.g. "Get Balance" → "Get Ethereum Address Balance")
- Made headings specific to actual query content (checked query code for context)
- Fixed grammar issues ("All transfers of a address", "Most Transfered")
- Covers: bitcoin, Solana, Dogecoin, stellar, cosmos, algorand, ripple, tron,
  hedera, filecoin, dexTrades, Transactions, Staking, Beacon Chain, cross-chain,
  smartcontract calls/events, address, transfers, tokens, Input_Output

Made-with: Cursor
Add SEO-MEASUREMENT.md and seo/ to .gitignore
4f3cefe 
Made-with: Cursor
SEO round 2: front matter for 15 .mdx files, unique descriptions for …
e00a74f 
…55 Schema pages, fix Dogecoin title

- Add title/description/keywords front matter to 15 .mdx example pages
  (Algorand, Avalanche, Bitcoin I/O, Hedera, Ripple, Velas) that had none
- Rewrite 55 templated Schema descriptions to be chain-specific and unique
  (Cronos, Algorand, Cardano, Celo, Conflux, Cosmos, Elrond, EOS, Filecoin,
  Flow, Harmony, Hedera, Solana, Stellar, Tezos, Velas)
- Fix duplicate "Dash Coinpath API" title on Dogecoin coinpath page
- Add Related Resources to Harmony/Tezos overviews and Zcash example pages
- Standardize Coinpath section headings to "Related Resources" with
  production URLs

Made-with: Cursor
Add deprecation notices for unsupported chains and revert Zcash zenze…
47261d2 
…c-api changes

- Add :::caution Deprecated admonition to Harmony, Tezos, Elrond, Conflux,
  EOS, and Velas overview pages (no longer supported by Bitquery)
- Revert zenzec-api.md to main branch version

Made-with: Cursor
Expand 31 thin high-impact pages with queryable fields and use-case g…
8b842ea 
…uidance

- Add "What You Can Query" and "Common Use Cases" sections to 19 Schema
  overview pages (Bitcoin, Ethereum, BSC, Solana, Polygon, Tron, Ripple,
  Avalanche, Cardano, Cosmos, Stellar, Algorand, Cronos, Celo, Dash,
  Dogecoin, Flow, Filecoin, Beacon Chain)
- Add "When to Use" / "Practical Tips" sections to 12 query-features and
  IDE guide pages (sorting, options, arguments, search, aliases, fragments,
  aggregation, expressions, utilities, network selection, app integration)

Made-with: Cursor
Add deprecation notices for ETH2 and Hedera, enterprise use cases, an…
d507f83 
…d expand 40 thin Schema detail pages

- Deprecation notices on all 8 ETH2 Beacon Chain pages and 9 Hedera pages
- Enterprise use-case bullets on 18 active chain overview pages
- Introductory context paragraphs on ~40 thinnest detail pages: address,
  addressStats, balance, blocks, coinpath, activeAddresses, mints,
  instructions, messages, arguments, and effectArguments across all
  actively supported chains

Made-with: Cursor
Add coinpath queries, Flow deprecation notices, and improve internal …
8adc187 
…linking across docs

- Add example GraphQL queries to 10 coinpath Schema pages (Ethereum, BSC, Cronos, Bitcoin, Dash, Dogecoin, Algorand, Celo, Cosmos, Tron)
- Add deprecation notices to all 15 Flow Schema pages (chain no longer supported)
- Fix self-referencing links in 9 coinpath Related Resources sections
- Add Examples links to 7 Schema overview pages (Ethereum, BSC, Polygon, Cronos, Celo, Dash, Cardano)
- Add Related Resources with Schema backlinks to 9 Example pages (Algorand, Avalanche, Bitcoin, Ripple)
- Improve internal linking on 8 guide pages (graphql-ide, building-queries)
- Fix Dogecoin coinpath intro text, standardize headings, normalize URL patterns

Made-with: Cursor
@buddies2705 buddies2705 changed the title Feat/v1 full seo improvements V1 Docs Full SEO Overhaul: metadata, content expansion, internal linking & deprecation notices Apr 2, 2026
Gaurav agarwal added 3 commits April 2, 2026 15:53
Enable showLastUpdateTime for docs pages
3120e8c 
Adds git-based "Last updated" timestamps to all doc pages, improving content freshness signals for SEO and user trust.

Made-with: Cursor
Remove showLastUpdateTime from blog (unsupported in Docusaurus 2.x)
11cc390 
Made-with: Cursor
Remove createRedirects from client-redirects plugin config
21e7c45 
Made-with: Cursor
@divyasshree-BQ divyasshree-BQ merged commit f27201c into main Apr 2, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@buddies2705 @divyasshree-BQ