Skip to content

docs(seo): cross-link integrations, cookbook recipes, and topic hubs - #75

Merged
nibzard merged 1 commit into
mainfrom
niko/seo-links
Jul 24, 2026
Merged

docs(seo): cross-link integrations, cookbook recipes, and topic hubs#75
nibzard merged 1 commit into
mainfrom
niko/seo-links

Conversation

@nibzard

@nibzard nibzard commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

What

Technical fix #4 from SEO-OPPORTUNITIES.md (Days 0–14): internal-linking depth. Integration pages, cookbook recipes, and topic hubs were under-connected — all 27 integration pages linked no topic hub, 8 orphan integration pages linked nothing, and topic hubs were pure <RecipeGrid> components with zero outbound integration links.

107 internal links woven into existing prose across 82 files:

  • Integrations — every page now links a relevant topic hub (agents for frameworks, computer-use for vision-loop pages, browser-automation for playwright/puppeteer/selenium). The 8 orphans (x402, replit, codex, claude-code, openclaw, pi-agent, hermes-agent, stackblitz) get internal links for the first time.
  • Recipes — backlinks to their matching integration page where one exists, plus a topic-hub link. Mapped non-identical names (openai-agents → openai-agents-sdk, vercel-ai-sdk → ai-sdk).
  • Topic hubs — a new ## Related integrations section after the recipe grid on 8 hubs (playwright, browser-use, computer-use, captchas, browser-automation, subagents, mobile, typed-output).

How it was built

Proposals drafted by 4 parallel agents (integrations / recipes A–G / recipes H–Z / topic hubs), each returning exact insertions with anchor snippets. I merged and validated all 107 against the real files before applying:

  • every link target exists on disk
  • every anchor text matches exactly once (or chains off a prior insertion)
  • no em dashes, no duplicate links

8 insert-after proposals glued onto preceding text on first apply (no leading whitespace); fixed each — 3 became their own paragraph after the recipe-link line, 5 got a sentence space.

Verified

  • bun run check (Biome): clean
  • bun run validate-links: 0 errors
  • Dev-server smoke test: all 7 edited page types + all link targets return 200
  • DOM check: new links render (computer-use hub shows all 3 integration links; selenium shows recipe + browser-automation; langgraph recipe shows agents hub + integration backlink)

Third Days-0-14 item from SEO-OPPORTUNITIES.md (technical fix #4):
internal-linking depth. Integration pages, cookbook recipes, and topic
hubs were under-connected (all 27 integration pages linked no topic hub;
8 orphan integration pages linked nothing; topic hubs were pure
RecipeGrids with zero outbound integration links).

107 internal links woven into existing prose across 82 files:
- Integrations: every page links a relevant topic hub (agents for
  frameworks, computer-use for vision-loop pages, browser-automation for
  playwright/puppeteer/selenium); the 8 orphans (x402, replit, codex,
  claude-code, openclaw, pi-agent, hermes-agent, stackblitz) get links
  for the first time.
- Recipes: backlinks to their matching integration page where one
  exists, plus a topic-hub link; mapped non-identical names
  (openai-agents -> openai-agents-sdk, vercel-ai-sdk -> ai-sdk).
- Topic hubs: a new Related integrations section after the recipe grid
  on 8 hubs (playwright, browser-use, computer-use, captchas,
  browser-automation, subagents, mobile, typed-output).

Proposals drafted by 4 parallel agents, validated against files (all
targets exist, anchors match, no em dashes, no duplicate links), and
applied verbatim. Verified: biome clean, validate-links 0 errors, all
edited pages and targets return 200, links render in the DOM.
@vercel

vercel Bot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Jul 24, 2026 4:36pm

Request Review

@nibzard
nibzard merged commit 4f0304b into main Jul 24, 2026
3 checks passed
@nibzard
nibzard deleted the niko/seo-links branch July 24, 2026 16:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant