Skip to content

[AIT-319] Add LiveObjects REST SDK usage docs#3258

Open
VeskeR wants to merge 1 commit intomainfrom
AIT-319/rest-sdk
Open

[AIT-319] Add LiveObjects REST SDK usage docs#3258
VeskeR wants to merge 1 commit intomainfrom
AIT-319/rest-sdk

Conversation

@VeskeR
Copy link
Contributor

@VeskeR VeskeR commented Mar 10, 2026

Docs for ably/ably-js#2109.

Largely based on the existing usage doc for the REST API [1].
Added REST SDK docs as a separate page for two reasons:

  1. There is no language selector for the shell/curl/HTTP "language", nor
    do I think it would look or feel nice UX-wise. It would only exist
    for this single page and may not be obvious to readers that they can
    switch it at the top to see SDK/API docs.
  2. The SDK docs differ in many minor details throughout, and it would be
    a nightmare to maintain different versions on the same page using
    if-lang blocks. Where large sections are unchanged (like the
    procedure to generate the client-generated object ID), the doc
    references the corresponding REST API section instead of duplicating
    it.

[1] https://ably.com/docs/liveobjects/rest-api-usage

Resolves AIT-319

Description

Checklist

@coderabbitai
Copy link

coderabbitai bot commented Mar 10, 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: 05cbd25f-f600-4d35-ab49-2023e47e617c

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 AIT-319/rest-sdk

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.

@VeskeR VeskeR added the review-app Create a Heroku review app label Mar 10, 2026
@ably-ci ably-ci temporarily deployed to ably-docs-ait-319-rest--qd9urv March 10, 2026 12:31 Inactive
@VeskeR VeskeR force-pushed the AIT-319/rest-sdk branch from f08cbfb to 2ac8d6a Compare March 10, 2026 14:16
@ably-ci ably-ci temporarily deployed to ably-docs-ait-319-rest--qd9urv March 10, 2026 14:17 Inactive
Largely based on the existing usage doc for the REST API [1].
Added REST SDK docs as a separate page for two reasons:
1. There is no language selector for the shell/curl/HTTP "language", nor
   do I think it would look or feel nice UX-wise. It would only exist
   for this single page and may not be obvious to readers that they can
   switch it at the top to see SDK/API docs.
2. The SDK docs differ in many minor details throughout, and it would be
   a nightmare to maintain different versions on the same page using
   if-lang blocks. Where large sections are unchanged (like the
   procedure to generate the client-generated object ID), the doc
   references the corresponding REST API section instead of duplicating
   it.

Resolves AIT-319

[1] https://ably.com/docs/liveobjects/rest-api-usage
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.

2 participants