Skip to content

fix: point documentation links at the migrated /docs/ URLs - #15

Open
crbdev wants to merge 1 commit into
mainfrom
fix/docs-urls-post-migration
Open

fix: point documentation links at the migrated /docs/ URLs#15
crbdev wants to merge 1 commit into
mainfrom
fix/docs-urls-post-migration

Conversation

@crbdev

@crbdev crbdev commented Aug 31, 2026

Copy link
Copy Markdown
Contributor

The user docs moved from docs.gravitykit.com to www.gravitykit.com/docs/ around 2026-05-01. Every reference in this repo still pointed at the old subdomain, so each one reached the new pages through a redirect chain.

This came out of a backlink audit for the docs migration (Linear MOPS-480 / MAR-148): docs.gravitykit.com still has 1,338 live backlinks from 120 referring domains, and this site is the largest single contributor.

Changes

File What it is
docusaurus.config.js Footer "Documentation" link — renders on every page, so it's the bulk of the count
src/pages/index.js Homepage "official GravityKit Documentation" link
scripts/enhance-for-llms.mjs Baked into the generated llms.txt, so AI assistants reading it were sent to the old host
README.md (×2) Support section link, plus the @see URL in the PHPDoc example

The README @see example previously showed https://docs.gravitykit.com/article/123. The new docs have no numeric /article/<id> paths, so docblocks copied from that example would have taught the dead format. It now points at a real current URL.

Verification

  • No docs.gravitykit.com references remain in the repo (excluding .git, node_modules, vendor).
  • Both replacement URLs return 200 with zero redirects:
    • https://www.gravitykit.com/docs/
    • https://www.gravitykit.com/docs/gravityview/getting-started/how-to-setup-your-first-view/

No behavioural change beyond the link targets; nothing here affects hook generation or the build.

🤖 Generated with Claude Code

The user docs moved from docs.gravitykit.com to
www.gravitykit.com/docs/ around 2026-05-01. Every reference here still
pointed at the old subdomain and reached the new pages through a
redirect chain.

The footer entry is the notable one: it renders on every page of the
site, so it was the single largest source of links still aimed at the
old subdomain. The enhance-for-llms.mjs string is baked into the
generated llms.txt, so AI assistants reading it were being sent to the
old host too.

The README @see example is updated to a real current URL so docblocks
copied from it use the new structure -- the new docs have no numeric
/article/<id> paths.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@crbdev
crbdev requested a review from zackkatz August 31, 2026 04:25
@coderabbitai

coderabbitai Bot commented Aug 31, 2026

Copy link
Copy Markdown

Important

  • 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 9d6c8e00-60af-46b2-b376-38f5a5434ead


Comment @coderabbitai help to get the list of available commands.

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