feat(docs): SEO/GEO sweep — sitelinks, JSON-LD, Y1 billing accuracy, cross-links#9
Merged
Merged
Conversation
…cross-links docs.json: - Fixed em-dash in og:image:alt (banned 2026-05-24); now matches apex brand.slogan - Added apex parity tags: twitter:image, twitter:image:alt, twitter:creator, format-detection, theme-color, author Per-page (24 .mdx): - keywords array on every page (5-8 lowercase terms per topic) - Tightened 4 descriptions to verb-first + number for AI anchoring - 18 new TechArticle JSON-LD + 1 FAQPage on support/faq (9 Q+A pairs auto-derived from existing Accordion blocks) - All @id cross-reference apex #organization / #website for entity consolidation in AI knowledge graphs Content drift fixes (verified against apex code, not just rules): - support/faq: MCP tool count Five to Six (MCP_TOOL_NAMES.length) in both visible Accordion AND FAQPage JSON-LD - support/faq: failure question rewritten for Y1 (charged on failure, no auto-refund, dispute route) - quickstart: POST response status dispatched to waiting - concepts/credits: removed pre-check / auto-refund language; added Negative balance / past_due subsection; swapped /billing/balance for real /billing/state shape; nanodollar narrative - 33 stale rb_live_ / rb_test_ key examples normalized to canonical rb_* (no test mode exists in production) Cross-linking (driving Google sitelinks + AI authority): - 24/24 pages now end with ## Related section (5 entries each, colon-separated, includes apex backlink + 3+ docs links) - ~14 inline cross-links added in body copy on first concept mention - 13 prominent apex backlinks added (drives docs to apex authority flow) - Zero weak anchors (here / click here / read more) anywhere in docs Em-dash purge: - 50+ hits in body, tables, headings scrubbed per writing-style rule - Banned 2026-05-24 as AI-aesthetic tell Internal links: - 2 broken /credits paths fixed to /concepts/credits
- cli/troubleshooting + mcp/troubleshooting: 'Troubleshoot' not in ALLOWED_VERBS, swap to 'Fix' - concepts/credits: description 170 to 150 chars
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.
Summary
Matches the apex SEO/GEO sweep (rendobar/rendobar#134) on the docs surface. Brings every docs page to parity with the apex SEO bar, fixes 4 confirmed content-drift bugs against live API code, and strengthens cross-linking for Google sitelinks + AI-citation density.
Changes
docs.json
Per-page SEO (24 MDX)
Content drift fixes (verified against live API code, not just docs rules)
Cross-linking (drives sitelinks + AI authority)
Em-dash purge
Internal links
Test plan
Related