Skip to content

Conversation

@GregHolmes
Copy link
Contributor

@GregHolmes GregHolmes commented Feb 6, 2026

Summary

Fix broken and incorrect internal link references across 55 files.

Categories of fixes

  • Broken links: Pages that don't exist and have no redirect (typos in paths, missing segments, wrong anchors)
  • Doubled URLs: Full URLs with /docs/docs/ duplication
  • Legacy references: Links to removed/renamed pages updated to current equivalents
  • Redirect-dependent links: Working links updated from old paths to canonical paths, removing unnecessary redirect hops

Broken links

File From To
liveobjects/lifecycle.mdx:76 /docs/channel/states /docs/channels/states
liveobjects/lifecycle.mdx:76 /docs/channel/states#failure /docs/channels/states#failure
ai-transport/messaging/citations.mdx:9 /docs/ai-transport/message-per-response /docs/ai-transport/token-streaming/message-per-response
ai-transport/sessions-identity/resuming-sessions.mdx:19 /docs/ai-transport/sessions-and-identity/online-status /docs/ai-transport/sessions-identity/online-status
ai-transport/token-streaming/message-per-response.mdx:10 /docs/ai-transport/token-rate-limits /docs/ai-transport/token-streaming/token-rate-limits
ai-transport/token-streaming/message-per-token.mdx:86 /docs/ai-transport/token-rate-limits /docs/ai-transport/token-streaming/token-rate-limits
platform/ai-llms/index.mdx:25 /docs/ai-llms/llms-txt /docs/platform/ai-llms/llms-txt
chat/moderation/direct/hive-dashboard.mdx:29 /docs/chat/rooms/moderation/hive-model-only /docs/chat/moderation/direct/hive-model-only
livesync/postgres/quickstart.mdx:135 /docs/livesync/models /docs/livesync/postgres/models
livesync/postgres/models.mdx:165 /docs/livesync/postgres/postgres-connector /docs/livesync/postgres
metadata-stats/stats.mdx:637 /docs/platform/pricing/limits/connection /docs/platform/pricing/limits#connection
api/realtime-sdk/history.mdx:704 /docs/api/realtime-sdk/historypaginated-result /docs/api/realtime-sdk/history#paginated-result

Doubled /docs/docs/ in full URLs

File From To
protocols/sse.mdx:172 https://ably.com/docs/docs/realtime/types https://ably.com/docs/api/realtime-sdk/types
push/configure/device.mdx:546 https://ably.com/docs/docs/api/realtime-sdk/push-admin /docs/api/realtime-sdk/push-admin
push/configure/device.mdx:627 https://ably.com/docs/docs/api/realtime-sdk/push-admin /docs/api/realtime-sdk/push-admin
push/configure/web.mdx:174 https://ably.com/docs/docs/api/realtime-sdk/push-admin /docs/api/realtime-sdk/push-admin

Legacy / removed page references

File From To
faq/push-faqs.mdx:40 /docs/push/configure/apns#sandbox /docs/faq/push-faqs#apns-sandbox
faq/push-faqs.mdx:116 /docs/general/channel-rules /docs/channels#rules
platform/integrations/queues.mdx:85 /docs/account/billing-and-payments#upgrading /docs/platform/pricing/billing#package-changes
livesync/mongodb/index.mdx:11 /docs/achieving-exactly-once-message-processing-with-ably /docs/platform/architecture/idempotency
push/configure/web.mdx:22 https://ably.com/docs/getting-started/setup /docs/getting-started

Redirect-dependent links updated to canonical paths

From To Files affected
/docs/channels/messages /docs/messages 11 files
/docs/pricing /docs/platform/pricing 5 files
/docs/account/control-api /docs/platform/account/control-api 4 files
/docs/getting-started/setup /docs/getting-started 3 files
/docs/realtime /docs/api/realtime-sdk 1 file
/docs/rest /docs/api/rest-sdk 1 file
/docs/rest-api /docs/api/rest-api 1 file
/docs/integrations /docs/platform/integrations 1 file
/docs/general/firehose /docs/platform/integrations/streaming 1 file
/docs/general/kafka-connector /docs/platform/integrations/inbound/kafka-connector 1 file
/docs/pricing/limits /docs/platform/pricing/limits 1 file
/docs/pricing/enterprise /docs/platform/pricing/enterprise 1 file
/docs/account /docs/platform/account 1 file (nav)

@GregHolmes GregHolmes self-assigned this Feb 6, 2026
@GregHolmes GregHolmes added the review-app Create a Heroku review app label Feb 6, 2026
@coderabbitai
Copy link

coderabbitai bot commented Feb 6, 2026

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch fix/broken-internal-links

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

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

@ably-ci ably-ci temporarily deployed to ably-docs-fix-broken-in-sdr7k3 February 6, 2026 23:03 Inactive
@GregHolmes GregHolmes temporarily deployed to ably-docs-fix-broken-in-sdr7k3 February 7, 2026 21:32 Inactive
@GregHolmes GregHolmes temporarily deployed to ably-docs-fix-broken-in-sdr7k3 February 7, 2026 21:40 Inactive
@GregHolmes GregHolmes temporarily deployed to ably-docs-fix-broken-in-sdr7k3 February 7, 2026 21:46 Inactive
@GregHolmes GregHolmes force-pushed the fix/broken-internal-links branch from 5f81fb5 to e460ccc Compare February 7, 2026 21:47
@GregHolmes GregHolmes temporarily deployed to ably-docs-fix-broken-in-sdr7k3 February 7, 2026 21:47 Inactive
@GregHolmes GregHolmes force-pushed the fix/broken-internal-links branch from e460ccc to 3d10e98 Compare February 7, 2026 21:51
@GregHolmes GregHolmes requested a review from m-hulbert February 7, 2026 21:51
@GregHolmes GregHolmes temporarily deployed to ably-docs-fix-broken-in-sdr7k3 February 7, 2026 21:51 Inactive
Copy link
Contributor

@m-hulbert m-hulbert left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some of these are changing redirect metadata (which shouldn't be changed) 🙂

@GregHolmes GregHolmes temporarily deployed to ably-docs-fix-broken-in-sdr7k3 February 9, 2026 09:51 Inactive
@GregHolmes GregHolmes requested a review from m-hulbert February 9, 2026 09:51
Copy link
Contributor

@m-hulbert m-hulbert left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

Update broken and incorrect link references across 55 files including
typos in paths, doubled /docs/docs/ URLs, legacy page references, and
links relying on redirects instead of pointing to canonical paths.
@GregHolmes GregHolmes force-pushed the fix/broken-internal-links branch from 2fd23b8 to ec30171 Compare February 9, 2026 09:57
@GregHolmes GregHolmes temporarily deployed to ably-docs-fix-broken-in-sdr7k3 February 9, 2026 09:58 Inactive
@GregHolmes GregHolmes merged commit 2837d8e into main Feb 9, 2026
6 checks passed
@GregHolmes GregHolmes deleted the fix/broken-internal-links branch February 9, 2026 10:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

review-app Create a Heroku review app

Development

Successfully merging this pull request may close these issues.

3 participants