Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 9 additions & 1 deletion src/pages/docs/protocols/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,14 @@ Ably SDKs are the recommended method for connecting to Ably because they offer s

Protocol adapters offer an alternative method for connecting to Ably. The advantage to protocol adapters is that they require fewer resources in terms of memory and network overhead such as in smaller footprint devices, or on a platform where an Ably SDK isn't available such as an Arduino-based IoT wearable. The potential drawback to consider when evaluating protocol adapters is that they do not support the full set of Ably features, for example the MQTT protocol adapter does not support presence, and the SSE protocol adapter does not support automatic token renewal.

## Migration support <a id="migration-support"/>
Copy link
Contributor

Choose a reason for hiding this comment

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

"Migrate to Ably"?


Ably helps customers migrate from other data streaming networks including PubNub and Pusher. Protocol adapters facilitate risk-free migration by allowing you to use existing protocols and client libraries while transitioning to Ably client libraries over time.
Copy link
Contributor

Choose a reason for hiding this comment

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

"Client libraries" to "SDKs" when referring to our own here too please.


Protocol adapters ensure interoperability between different protocols. For example, you can publish sensor data from an MQTT device, subscribe to that data using a Pusher client library for dashboard display, support mobile apps using Ably SDKs, and process data using AMQP worker queues - all within the same system.

Migration times typically range from a few hours (using protocol adapters) to a week, depending on your migration strategy and whether you choose to adopt Ably's native SDKs immediately or transition gradually.

A full list of Ably SDKs can be found on the [SDK page](/docs/sdks).

## Available Protocol Adapters <a id="available-adapters"/>
Expand All @@ -26,7 +34,7 @@ Ably supports multiple protocols in addition to the native WebSockets-based one:

MQTT (MQ Telemetry Transport) is a publish/subscribe, lightweight messaging protocol designed for constrained devices and low-bandwidth networks. One of the major uses of MQTT is with IoT (Internet of Things), where these principles are key to having effective communication between various devices.

MQTT can also be used with Ably as a basic event broker or if we don't have an SDK for your target platform. However, without an SDK you don't get access to the full range of platform features and data guarantees.
MQTT can also be used with Ably as a basic event broker or if an SDK is not available for your target platform. However, without an SDK you don't get access to the full range of platform features and data guarantees.

Read more in the [MQTT section](/docs/protocols/mqtt).

Expand Down
14 changes: 14 additions & 0 deletions src/pages/docs/protocols/pubnub.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,20 @@ Many of the advantages associated with using Ably, such as the use of WebSockets

You can use PuBNub and and an Ably SDK side-by-side as they are interoperable, with the exception of a few features.

For a detailed comparison of Ably and PubNub features, see [Ably vs PubNub](https://ably.com/compare/ably-vs-pubnub).

## Migration process <a id="migration-process"/>

A typical migration from PubNub to Ably follows these steps:
Copy link
Contributor

Choose a reason for hiding this comment

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

Can we change "Ably client libraries" to "Ably SDKs" please.


1. Change the host name for all of your PubNub client library integrations to use Ably's endpoints.

2. Migrate one app at a time over to Ably client libraries. At this stage, some of your apps will be using PubNub client libraries and others will be using Ably's client libraries. Since the adapter translates the PubNub protocol, there's no interruption and interoperability between both protocols is maintained.

3. Migrate all your apps and servers to use Ably client libraries and terminate your old contracts.

If you're interested in migrating from PubNub using protocol adapters, [get in touch](https://ably.com/contact).
Copy link
Contributor

Choose a reason for hiding this comment

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

I don't think this is necessary in the docs considering the steps are outline here.


## Supported features <a id="features"/>

The following PubNub features are supported using the adapter:
Expand Down