Docs deep audit: retention/billing pages, streams & migration guides, AEO + infra fixes#223
Merged
Conversation
…, AEO Implements the July 2026 documentation audit (support-demand-driven). All facts founder-verified (rate limits, points, trial, retention windows, Kafka auth, API names). Build passes; check-links strict = 0 errors. Infra & config: - nginx: real 404s (was site-wide soft-404s), server-side 301s (old PumpFun casing, /blog); gzip for JS/CSS/SVG/JSON; removed dead Netlify _redirects/_headers - analytics: GA4 loads only via GTM (removed duplicate gtag.js double-counting) - real favicon.ico + apple-touch-icon; JetBrains Mono preloads; theme-color meta - fixed broken IDE links; navbar V2-first + V1 legacy; onBrokenMarkdownLinks: throw - scripts/check-links.mjs (build-first, slug-aware) wired into CI New pages (gaps mined from support channels): - Data Coverage & Retention matrix; Plans/Points/Limits; Rate Limits & Concurrency - Kafka Operations Cookbook; expanded errors/troubleshooting with real error strings - Recipes: wallet PnL, wallet provenance - Migrating-from guides: Moralis, Alchemy, Helius, Yellowstone/CoreCast, GoldSky - Chinese landing page (auto-translate guidance) AEO / structured data: - llms-full.txt now carries full page text + raw .md route twins - TechArticle + BreadcrumbList JSON-LD (with datePublished/description) - FAQ blocks (FAQPage schema) on new pages Editorial / IA: - Plans + Migration sidebar sections; 18 category-page descriptions - code-fence language tags (~548); alt text on all 28 images - contribution-guidelines: docs-first governance rules Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…links - #7: add "More guides" cross-link block (retention, errors, plans, first-query) to the 10 chain hubs that lacked it (Solana already had it) - #8: robots.txt — add Disallow (graphql-reference, search) under each named AI bot group so they inherit the same exclusions as the wildcard group - #8: static/llms.txt — convert 27 root-relative links to absolute URLs so scrapers reading the file out of context resolve them (skipped v1-sunsetting-related items per founder) Verified: yarn build passes; check-links strict = 0 errors. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…lated-pages - (a) swept 22 graphql.bitquery.io/ide links -> ide.bitquery.io across 17 files - (b) H1 hygiene: added missing H1 to 13 pages, demoted extra H1s on 10 pages; expanded thin pages (schema-intro, websocket auth) and added useful cross-links/notes to IDE stubs + nft-creator tutorial page - (c) auto "Related pages" footer: swizzled DocItem/Content now renders sidebar siblings on every doc (no per-page frontmatter), mechanically removing dead-ends and adding inbound links; renders nothing when no category siblings Verified: yarn build passes (SSR renders the block on all pages); check-links strict = 0 errors. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Per founder: the manual "Next steps" sections cover related-links, so the auto-generated sidebar-sibling footer isn't needed. Restore DocItem/Content to just the Copy-MD button; remove the .related-pages CSS. (The IDE-link sweep, H1 hygiene, and thin-page expansions from the prior commit are unaffected.) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
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
1 participant
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.
Implements the July 2026 documentation audit — support-demand-driven pages plus SEO/AEO and infra fixes. All support-derived facts are founder-verified (rate limits, points, trial, retention windows, Kafka auth, API names).
yarn buildpasses and the new link checker reports zero broken internal links.New pages
Infra & config
/blog), gzip for JS/CSS/SVG/JSON; removed dead Netlify_redirects/_headersgtag.jsthat double-counted pageviews)favicon.ico+apple-touch-icon; JetBrains Mono preload;theme-color;onBrokenMarkdownLinks: throw/forms/api; navbar V2-first, V1 "legacy"scripts/check-links.mjs(build-first, slug-aware) wired into CIAEO / structured data
llms-full.txtnow carries full page text + raw.mdroute twinsdatePublished/description)llms.txtEditorial / IA
graphql.bitquery.io/idelinks →ide.bitquery.ioKnown follow-ups (not in this PR)
<lastmod>; broadergraphql.bitquery.ioreference sweep; GSC property access; a few backlog pages (cloud/S3 schema, methodology statement, labels/coinpath, "not supported").🤖 Generated with Claude Code