Update docs re ably-js v2 API

Author: VeskeR

README.md

@@ -76,7 +76,7 @@ To instantiate the Spaces SDK, create an [Ably client](https://ably.com/docs/get
 import Spaces from '@ably/spaces';
 import { Realtime } from 'ably';
 
-const client = new Realtime.Promise({ key: "<API-key>", clientId: "<client-ID>" });
+const client = new Realtime({ key: "<API-key>", clientId: "<client-ID>" });
 const spaces = new Spaces(client);
 ```
 You can use [basic authentication](https://ably.com/docs/auth/basic) i.e. the API Key directly for testing purposes, however it is strongly recommended that you use [token authentication](https://ably.com/docs/auth/token) in production environments.
@@ -95,7 +95,7 @@ You can also use Spaces with a CDN, such as [unpkg](https://www.unpkg.com/):
 After this, instantiate the SDK in the same way as in the NPM option above:
 
 ```ts
-const client = new Ably.Realtime.Promise({ key: "<API-key>", clientId: "<client-ID>" });
+const client = new Ably.Realtime({ key: "<API-key>", clientId: "<client-ID>" });
 const spaces = new Spaces(client);
 ```
 

docs/connection-and-channel-management.md

@@ -9,7 +9,7 @@ This document describes how to access a connection and channels on Spaces, and w
 When initializing the Spaces SDK, an Ably client is passed as a required argument:
 
 ```ts
-const client = new Realtime.Promise({ key: "<API-key>", clientId: "<client-ID>" });
+const client = new Realtime({ key: "<API-key>", clientId: "<client-ID>" });
 const spaces = new Spaces(client);
 ```
 
@@ -50,4 +50,4 @@ mySpace.cursors.subscribe('update', () => {});
 
 - [Channels](https://ably.com/docs/channels)
 - [Channel states](https://ably.com/docs/channels#states)
-- [Handle channel failure](https://ably.com/docs/channels#failure)
+- [Handle channel failure](https://ably.com/docs/channels#failure)

docs/react.md

@@ -43,7 +43,7 @@ import { Realtime } from "ably";
 import Spaces from "@ably/spaces";
 import { SpacesProvider, SpaceProvider } from "@ably/spaces/react";
 
-const ably = new Realtime.Promise({ key: "your-ably-api-key", clientId: 'me' });
+const ably = new Realtime({ key: "your-ably-api-key", clientId: 'me' });
 const spaces = new Spaces(ably);
 
 root.render(

docs/usage.md

@@ -39,19 +39,19 @@ You can also use Spaces with a CDN like [unpkg](https://www.unpkg.com/):
 
 > **Note**
 >
-> If you do this, then replace the call to `new Realtime.Promise` in the next section with `new Ably.Realtime.Promise`.
+> If you do this, then replace the call to `new Realtime` in the next section with `new Ably.Realtime`.
 
 ## Authentication and instantiation
 
-Spaces use an [Ably promise-based realtime client](https://github.com/ably/ably-js#using-the-async-api-style). You can pass an Ably client directly to the spaces constructor.
+You can pass an Ably client directly to the spaces constructor.
 
 The Ably client instantiation accepts client options. You will need at minimum an [Ably API key](#ably-api-key) and a [clientId](https://ably.com/docs/auth/identified-clients?lang=javascripts). A clientId represents an identity of an connection. In most cases this will something like the id of a user:
 
 ```ts
-import { Realtime } from 'ably/promise';
+import { Realtime } from 'ably';
 import Spaces from '@ably/spaces';
 
-const client = new Realtime.Promise({ key: "<API-key>", clientId: "<client-ID>" });
+const client = new Realtime({ key: "<API-key>", clientId: "<client-ID>" });
 const spaces = new Spaces(client);
 ```
 

src/Spaces.ts

@@ -36,7 +36,7 @@ class Spaces {
   readonly version = VERSION;
 
   /**
-   * Create a new instance of the Spaces SDK by passing an instance of the [Ably promise-based realtime client](https://ably.com/docs/getting-started/setup). A [`clientId`](https://ably.com/docs/auth/identified-clients) is required.
+   * Create a new instance of the Spaces SDK by passing an instance of the [Ably realtime client](https://ably.com/docs/getting-started/setup). A [`clientId`](https://ably.com/docs/auth/identified-clients) is required.
    *
    * An Ably API key is needed to authenticate. [Basic authentication](https://ably.com/docs/auth/basic) may be used for convenience, however Ably strongly recommends you use [token authentication](https://ably.com/docs/auth/token) in a production environment.
    *