Skip to content

Add redirects for pages returning 404 - #3140

Open
mintlify[bot] wants to merge 2 commits into
mainfrom
autopilot/7dc6547c
Open

mintlify[bot] wants to merge 2 commits into
mainfrom
autopilot/7dc6547c

Conversation

@mintlify

@mintlify mintlify Bot commented Nov 13, 2026 •

Copy link
Copy Markdown
Contributor

Adds redirects for URLs readers keep hitting that return 404 since the Mintlify launch, mostly old Horizon paths missing api-reference/. Visitor counts are since 2026-10-22, excluding bots and a single scraper (aocr.org referrer).

Source Destination Visitors Evidence
/docs/data/apis/horizon/errors/:slug* …/horizon/api-reference/errors/:slug* ~75 All error pages live under api-reference/errors/. Also fixes /api/errors/* chaining through /api/:slug*
/docs/data/apis/horizon/introduction/:slug* …/horizon/api-reference/structure/:slug* ~30 streaming, rate-limiting, xdr, pagination and response-format all exist under structure/. Also fixes /api/introduction/*
/docs/data/apis/horizon/resources/:slug* …/horizon/api-reference/resources/:slug* ~30 Resource category pages exist under api-reference/resources/
/docs/data/apis/horizon/aggregations/:slug* …/horizon/api-reference/aggregations/:slug* ~10 Same layout under api-reference/aggregations/
3 exact old /api/ targets (payment object, fee stats, async submission errors) Per reviewer n/a Followed old /api/ URLs that the wildcards don't resolve. Placed above the wildcards
/docs/platforms/anchor-platform/{2.8,2.9,2.10,2.11,3.0,3.1,next}/:slug* (7) /docs/platforms/anchor-platform/:slug* ~130 paths Drops the removed version segment (ap_versioned_docs/, bf93f22). About half the old pages exist at the same unversioned path
/docs/data/apis/rpc/methods/:slug* /docs/data/apis/rpc/api-reference/methods/:slug* 6 Missing api-reference/ segment
/docs/data/apis/rpc/api-reference/pagination …/rpc/api-reference/structure/pagination 3 Missing structure/ segment
/docs/learn/encyclopedia/network-configuration/{federation,inflation,ledger-headers,network-passphrases} (4) Same destinations as the existing flat /docs/learn/encyclopedia/<page> redirects 12 Nested paths from #1670 were never redirected
/docs/learn/fundamentals/contract-development/errors …/contract-development/errors-and-debugging/errors 10 Missing errors-and-debugging/ segment
/docs/learn/glossary/liquidity-pool …/liquidity-on-stellar-sdex-liquidity-pools#liquidity-pools 6 Singular of the existing liquidity-pools redirect
/docs/build/apps/connect-to-anchors /docs/build/apps/example-application-tutorial/anchor-integration 6 Replaced by anchor-integration in #185
/docs/learn/fundamentals/list-of-operations /docs/learn/fundamentals/transactions/list-of-operations 4 Moved in #646
/docs/learn/smart-contract-internals/stellar-asset-contract /docs/tokens/stellar-asset-contract 4 Matches sibling SAC redirects

Left alone (unclear destination): /docs/tools/developer-tools/ai-bot and /docs/tools/ai (Stella removed in #2571), /docs/learn/interactive/dapps/challenges/* (removed), /docs/learn/encyclopedia/error-handling, and /nonexisting-page-g (a soft-404 probe).

@mintlify

mintlify Bot commented Nov 13, 2026 •

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
stellar-docs 🟢 Ready View Preview Nov 13, 2026, 11:01 PM

@ElliotFriend

Copy link
Copy Markdown
Contributor

Thanks, the wildcards check out on the preview. Two additions, please. #3141 just merged and removed the .html redirects, so expect a conflict in config/redirects.json.

  1. Exact redirects for five old /api/ URLs that still 404. Put them above your section wildcards, which also match these paths.
Source Destination
/docs/data/apis/horizon/resources/operations/object/payment /docs/data/apis/horizon/api-reference/resources/payments/object
/docs/data/apis/horizon/resources/retrieve-fee-stats /docs/data/apis/horizon/api-reference/retrieve-fee-stats
/docs/data/apis/horizon/errors/http-status-codes/horizon-specific/transaction-submission-async/:slug* /docs/data/apis/horizon/api-reference/errors/http-status-codes/horizon-specific
  1. One rule per Anchor Platform version (2.8, 2.9, 2.10, 2.11, 3.0, 3.1, and next) that drops the version: /docs/platforms/anchor-platform/<version>/:slug* to /docs/platforms/anchor-platform/:slug*. About half of the old pages still exist at the same path. The rest were restructured and still 404, which is no worse than today.
How I checked
  • /api/ URLs: I followed 70 old /api/... URLs from this repo's history on production and on this preview. Production resolves 56, this PR resolves 65, and the five above are the rest.
  • Anchor Platform: I compared the ap_versioned_docs/ folders (removed in bf93f22) with the current pages. 36 to 39 of each version's ~82 pages match.

@mintlify

mintlify Bot commented Nov 13, 2026

Copy link
Copy Markdown
Contributor Author

Thanks, the wildcards check out on the preview. Two additions, please. #3141 just merged and removed the .html redire…

@ElliotFriend I merged main and resolved the conflict, so the PR now only adds lines. Your three exact /api/ redirects are above the section wildcards, and the seven Anchor Platform version rules come after them. The link check passes with --check-redirects.

Your comment mentions five /api/ URLs, but the table only lists three. Can you send the other two?

@stellar-doxie

stellar-doxie Bot commented Nov 13, 2026

Copy link
Copy Markdown
Contributor

🤖 Automated message from the Stellar Triage Bot.

I saw this PR. Nobody has called me in, so I will not review it.

How to reach me:

  • Anyone with write permission can call me in. Comment /triage or add the bot:take label.
  • The PR author can send me away with /triage stop. People with write permission can also add the bot:hands-off label.
  • A review request to a maintainer does not call me in. It asks for that person's judgment.

This branch was successfully deployed

1 active deployment
staging — c9b9acf1 Deployed Nov 13, 2026 by mintlify[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