Skip to content

feat: link the comparison cluster from post bodies, not only the end box - #281

Merged
sonpiaz merged 2 commits into
mainfrom
feat/blog-internal-links
Nov 16, 2026
Merged

sonpiaz merged 2 commits into
mainfrom
feat/blog-internal-links

Conversation

@sonpiaz

@sonpiaz sonpiaz commented Nov 14, 2026

Copy link
Copy Markdown
Member

Draft. Waiting for the founder's approval before it leaves draft; do not merge.

What

Internal links for the comparison cluster on the blog. Until now, the comparison and alternatives posts linked each other almost only from the "More comparisons" box at the end of each post. This adds linking sentences in the body. No price, fee, number or verdict changes, no frontmatter change, and the "More comparisons" boxes are untouched.

  • Best-of comparison page (best-affiliate-software-saas): links to Rewardful vs FirstPromoter, Rewardful alternatives, FirstPromoter alternatives, PartnerStack alternatives and Dub vs PartnerStack in "So which affiliate software should you actually buy?". Links to the Stripe integration page, Tolt vs Rewardful, Tolt alternatives, Rewardful vs Dub and FirstPromoter vs Dub in the intro of "Tracking, setup and switching".
  • Alternatives posts: each Dub Partners section links its Dub head-to-head. The FirstPromoter sections in Rewardful alternatives and Tolt alternatives link FirstPromoter alternatives. Each "What's next" links the launch guide with its keyword as the anchor text.
  • Stripe walkthrough (stripe-affiliate-program): Step 2 links the Stripe integration page.
  • Ten comparison posts: each links back to the best-of page near the top, with the anchor "best affiliate software for SaaS".

Anchor text is the target post's keyword. Links to app pages are absolute (https://affitor.com/...), like the existing /pricing and /welcome links.

Notes

  • The links in the best-of page's FAQ section were deliberately not added to the FAQ answers. Those answers must match the frontmatter faq used for the FAQPage JSON-LD exactly (checkComparison in scripts/check-agent-surface.mjs). The same links sit in the "Tracking, setup and switching" intro instead.
  • In the four alternatives posts, the link back to the best-of page is its own short paragraph after the Quick answer, so the Quick answer paragraph stays whole.

Checks

  • Independent review: round 1 found one wording issue, which is fixed; round 2 passed on 709f904.
  • Every quoted anchor sentence exists in the source, and every target answers 200.
  • Local scripts/check-agent-surface.mjs: tracking contract PASS. The full check needs a build; CI runs it on this PR.
  • git diff --check is clean, and the new text has no em dashes.

🤖 Generated with Claude Code

sonpiaz and others added 2 commits November 14, 2026 10:11
The best-of comparison page now links its comparison and alternatives posts
from the paragraphs that discuss each tool, and each comparison post links
back to it near the top. Alternatives posts link the head-to-heads in their
Dub Partners and FirstPromoter sections, the launch guide from What's next,
and the Stripe walkthrough links the Stripe integration page. Only linking
sentences are added; no price, fee or verdict changes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…tence

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vercel

vercel Bot commented Nov 14, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
affitor-docs Ready Ready Preview Nov 14, 2026 6:19pm UTC

Request Review

@sonpiaz
sonpiaz marked this pull request as ready for review November 16, 2026 18:53
@sonpiaz
sonpiaz merged commit cc95cb3 into main Nov 16, 2026
4 checks passed

This branch was successfully deployed

1 active deployment
Preview — 709f904f Deployed Nov 14, 2026 by vercel[bot]
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