Skip to content

[DX-1100] Fix broken links, hardcoded keys, and misguided references across docs#3342

Draft
sacOO7 wants to merge 2 commits intomainfrom
fix/broken-links
Draft

[DX-1100] Fix broken links, hardcoded keys, and misguided references across docs#3342
sacOO7 wants to merge 2 commits intomainfrom
fix/broken-links

Conversation

@sacOO7
Copy link
Copy Markdown
Contributor

@sacOO7 sacOO7 commented Apr 16, 2026

  • Fixes https://ably.atlassian.net/browse/DX-1100
  • Fix ~50 broken or incorrect internal links across API references, getting-started guides, auth docs, and platform
    pages (wrong anchors, outdated paths, trailing dots in fragments)
  • Convert absolute ably.com/docs and ably.io URLs to relative /docs/ paths and update http:// to https://
    for external links (ruby-doc.org)
  • Replace hardcoded 'your-api-key' / '<YOUR_API_KEY>' strings with {{API_KEY}} template variable in code
    examples
  • Add missing hyperlinks where features were mentioned as plain text (Spaces features, Chat features)
  • Fix minor copy issues: localhost URL in production docs, stale TODO comment, incorrect SDK constructor syntax,
    improved meta descriptions

… docs

Fix incorrect internal anchors (e.g. #api-key → #api-keys, #skipping → skip-integrations), convert absolute ably.com URLs to relative paths,
upgrade http:// to https:// for external links,
replace hardcoded API keys with {{API_KEY}} template variable,
add missing hyperlinks for feature references,
remove trailing dots from anchor fragments,
and fix minor copy issues including a localhost URL and stale TODO comment.
@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Apr 16, 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.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 438a5965-c006-4932-8780-22f40beb2277

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
  • Commit unit tests in branch fix/broken-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.

@sacOO7 sacOO7 changed the title Fix broken links, hardcoded keys, and misguided references across docs [DX-1100] Fix broken links, hardcoded keys, and misguided references across docs Apr 16, 2026
… content

Fix broken internal anchors (e.g. #presence-multiple-client-id → #multiple-client-ids,
#app-limits → #account), correct missing leading slashes in link paths,
replace hardcoded API keys with {{API_KEY}}, standardize "real-time" to
"realtime" and "Ably Realtime SDK" to "Ably Pub/Sub SDK", update past-date
deprecation pages to past tense, fix a missing code block closure in
chat data-extraction, and add cross-references for Chat moderation.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant