Update the rest of JS API references to ably-js v2 - Promises and API

This includes next changes for the JS API:
- update Messages docs
- update ClientOptions docs
- update Encryption docs
- update Stats docs
- update Request docs
- update Connection docs
- update Presence docs
- update Authentication docs
- update History docs
- update Push Device docs
- update PushAdmin docs
- update PaginatedResult and HttpPaginatedResponse docs
- add docs for batch publish and batch presence
- various formatting, styling and bug fixes across the board

Author: VeskeR

content/api/realtime-sdk.textile

@@ -122,7 +122,7 @@ h6(#connect).
   csharp: Connect
 
 bq(definition).
-  default: connect()
+  default: connect(): void
   ruby:    "Deferrable":/docs/api/realtime-sdk/types#deferrable connect -> yields "@Connection@":/docs/api/realtime-sdk/connection
   java:    void connect()
   csharp:  void Connect()
@@ -143,7 +143,7 @@ h6(#close).
   csharp: Close
 
 bq(definition).
-  default: close()
+  default: close(): void
   ruby:    "Deferrable":/docs/api/realtime-sdk/types#deferrable close -> yields "@Connection@":/docs/api/realtime-sdk/connection
   java:    void close()
   csharp:  void Close()
@@ -164,14 +164,14 @@ h6(#stats).
   csharp: Stats
 
 bq(definition).
-  default: stats(Object options, callback("ErrorInfo":/docs/api/realtime-sdk/types#error-info err, "PaginatedResult":/docs/api/realtime-sdk/types#paginated-result<"Stats":#stats> results))
-  jsall: stats(params?): Promise<"PaginatedResult":/docs/api/realtime-sdk/types#paginated-result<"Stats":#stats>>
-  ruby:    "Deferrable":/docs/api/realtime-sdk/types#deferrable stats(Hash options) -> yields "PaginatedResult":/docs/api/realtime-sdk/types#paginated-result<"Stats":#stats>
-  java:    "PaginatedResult":/docs/api/realtime-sdk/types#paginated-result<"Stats":#stats> stats("Param":#param[] options)
-  swift,objc: stats(query: ARTStatsQuery?, callback: ("ARTPaginatedResult":/docs/api/realtime-sdk/types#paginated-result<"ARTStats":/docs/api/realtime-sdk/types#stats>?, ARTErrorInfo?) -> Void) throws
-  csharp:  Task<"PaginatedResult":/docs/api/realtime-sdk/types#paginated-result<"Stats":/docs/api/realtime-sdk/types#stats>> StatsAsync(StatsRequestParams query)
+  default: stats(Object options, callback("ErrorInfo":/docs/api/realtime-sdk/types#error-info err, "PaginatedResult":/docs/api/realtime-sdk/types#paginated-result<"Stats":#stats-type> results))
+  jsall:   stats(Object params?): Promise<"PaginatedResult":/docs/api/realtime-sdk/types#paginated-result<"Stats":#stats-type>>
+  ruby:    "Deferrable":/docs/api/realtime-sdk/types#deferrable stats(Hash options) -> yields "PaginatedResult":/docs/api/realtime-sdk/types#paginated-result<"Stats":#stats-type>
+  java:    "PaginatedResult":/docs/api/realtime-sdk/types#paginated-result<"Stats":#stats-type> stats("Param":#param[] options)
+  swift,objc: stats(query: ARTStatsQuery?, callback: ("ARTPaginatedResult":/docs/api/realtime-sdk/types#paginated-result<"ARTStats":#stats-type>?, ARTErrorInfo?) -> Void) throws
+  csharp:  Task<"PaginatedResult":/docs/api/realtime-sdk/types#paginated-result<"Stats":#stats-type>> StatsAsync(StatsRequestParams query)
 
-This call queries the "REST @/stats@ API":/docs/api/rest-api#stats and retrieves your application's usage statistics. A "PaginatedResult":/docs/api/realtime-sdk/types#paginated-result is returned, containing an array of "Stats":#stats for the first page of results. "PaginatedResult":/docs/api/realtime-sdk/types#paginated-result objects are iterable providing a means to page through historical statistics. "See an example set of raw stats returned via the REST API":/docs/metadata-stats/stats#metrics.
+This call queries the "REST @/stats@ API":/docs/api/rest-api#stats and retrieves your application's usage statistics. A "PaginatedResult":/docs/api/realtime-sdk/types#paginated-result is returned, containing an array of "Stats":#stats-type for the first page of results. "PaginatedResult":/docs/api/realtime-sdk/types#paginated-result objects are iterable providing a means to page through historical statistics. "See an example set of raw stats returned via the REST API":/docs/metadata-stats/stats#metrics.
 
 See "statistics":/docs/metadata-stats/stats for more information.
 
@@ -183,18 +183,18 @@ h6(#time).
 
 bq(definition).
   default: time(callback("ErrorInfo":/docs/api/realtime-sdk/types#error-info err, Number time))
-  jsall: time(): Promise<Number>
-  ruby:   "Deferrable":/docs/api/realtime-sdk/types#deferrable time -> yields Time
-  java:   long time()
-  csharp: Task<DateTimeOffset> TimeAsync()
+  jsall:   time(): Promise<Number>
+  ruby:    "Deferrable":/docs/api/realtime-sdk/types#deferrable time -> yields Time
+  java:    long time()
+  csharp:  Task<DateTimeOffset> TimeAsync()
   objc,swift: time(callback: (NSDate?, NSError?) -> Void)
 
 Obtains the time from the Ably service as <span lang="ruby">a @Time@ object</span><span lang="csharp">a @DateTimeOffset@ object</span><span lang="default">milliseconds since epoch</span>. (Clients that do not have access to a sufficiently well maintained time source and wish to issue Ably "TokenRequests":/docs/api/realtime-sdk/authentication#token-request with a more accurate timestamp should use the @queryTime@ "clientOptions":#client-options instead of this method).
 
 blang[jsall].
   h4. Returns
 
-  Returns a promise. On success, the promise is fulfilled with the time as milliseconds since the Unix epoch. On failure, the promise is rejected with an "@ErrorInfo@":/api/realtime-sdk/types#error-info object.
+  Returns a promise. On success, the promise is fulfilled with the time as milliseconds since the Unix epoch. On failure, the promise is rejected with an "@ErrorInfo@":/docs/api/realtime-sdk/types#error-info object.
 
 blang[objc,swift].
   h4. Callback result
@@ -236,38 +236,38 @@ blang[javascript].
   There are two overloaded versions of this method:
 
   bq(definition#batchPublish).
-    default:  batchPublish(spec): Promise<BatchResult<BatchPublishSuccessResult | BatchPublishFailureResult>>
+    default:  batchPublish("BatchPublishSpec":#batch-publish-spec spec): Promise<"BatchResult":#batch-result<"BatchPublishSuccessResult":#batch-publish-success-result | "BatchPublishFailureResult":#batch-publish-failure-result>>
 
-  Publishes a "@BatchPublishSpec@":LINK object to one or more channels, up to a maximum of 100 channels.
+  Publishes a "@BatchPublishSpec@":#batch-publish-spec object to one or more channels, up to a maximum of 100 channels.
 
   bq(definition#batchPublishArray).
-    default:  batchPublish(specs): Promise<BatchResult<BatchPublishSuccessResult | BatchPublishFailureResult>[]>
+    default:  batchPublish("BatchPublishSpec[]":#batch-publish-spec specs): Promise<"BatchResult":#batch-result<"BatchPublishSuccessResult":#batch-publish-success-result | "BatchPublishFailureResult":#batch-publish-failure-result>[]>
 
-  Publishes one or more "@BatchPublishSpec@":LINK objects to one or more channels, up to a maximum of 100 channels.
+  Publishes one or more "@BatchPublishSpec@":#batch-publish-spec objects to one or more channels, up to a maximum of 100 channels.
 
   h4. Parameters
 
-  - spec := an object describing the messages to be batch published and to which channels<br>__Type: "@BatchPublishSpec@":LINK__
-  - specs := an array of objects describing the messages to be batch published and to which channels<br>__Type: "@BatchPublishSpec@[]":LINK__
+  - spec := an object describing the messages to be batch published and to which channels<br>__Type: "@BatchPublishSpec@":#batch-publish-spec
+  - specs := an array of objects describing the messages to be batch published and to which channels<br>__Type: "@BatchPublishSpec@[]":#batch-publish-spec
 
   h4. Returns
 
-  Returns a promise. On success, the promise is fulfilled with a "@BatchResult@":/LINK object, or an array of @BatchResult@ objects, containing information about the result of the batch publish operation for each channel. The successful results of specific channels are returned as "@BatchPublishSuccessResult@":/LINK objects, whilst failures are "@BatchPublishFailureResult@":/LINK objects. If an array of @BatchResult@ objects are returned, they are in the same order as the provided "@BatchPublishSpec@":/LINK. On failure, the promise is rejected with an "@ErrorInfo@":/api/realtime-sdk/types#error-info object.
+  Returns a promise. On success, the promise is fulfilled with a "@BatchResult@":#batch-result object, or an array of "@BatchResult@":#batch-result objects, containing information about the result of the batch publish operation for each channel. The successful results of specific channels are returned as "@BatchPublishSuccessResult@":#batch-publish-success-result objects, whilst failures are "@BatchPublishFailureResult@":#batch-publish-failure-result objects. If an array of "@BatchResult@":#batch-result objects are returned, they are in the same order as the provided "@BatchPublishSpec@":#batch-publish-spec. On failure, the promise is rejected with an "@ErrorInfo@":/docs/api/realtime-sdk/types#error-info object.
 
   h6(#batchPresence). batchPresence
 
   bq(definition#batchPresence).
-    default: batchPresence(channels): Promise<BatchResult<BatchPresenceSuccessResult | BatchPresenceFailureResult>[]>
+    default: batchPresence(String[] channels): Promise<"BatchResult":#batch-result<"BatchPresenceSuccessResult":#batch-presence-success-result | "BatchPresenceFailureResult":#batch-presence-failure-result>[]>
 
-  Retrieves the presence state for one or more channels, up to a maximum of 100 channels. Presence state includes the "@clientId@":#client-options of members and their current "@PresenceAction@":/api/realtime-sdk/presence#presence-action
+  Retrieves the presence state for one or more channels, up to a maximum of 100 channels. Presence state includes the "@clientId@":#client-options of members and their current "@PresenceAction@":/docs/api/realtime-sdk/presence#presence-action.
 
   h4. Parameters
 
   - channels := an array of one or more channel names, up to a maximum of 100 channels<br>__Type: @String[]@__
 
   h4. Returns
 
-  Returns a promise. On success, the promise is fulfilled with a "@BatchResult@":/LINK object containing information about the result of the batch presence request for each channel. The successful results of specific channels are returned as "@BatchPresenceSuccessResult@":/LINK objects, whilst failures are "@BatchPresenceFailureResult@":/LINK objects. On failure, the promise is rejected with an "@ErrorInfo@":/api/realtime-sdk/types#error-info object.
+  Returns a promise. On success, the promise is fulfilled with a "@BatchResult@":#batch-result object containing information about the result of the batch presence request for each channel. The successful results of specific channels are returned as "@BatchPresenceSuccessResult@":#batch-presence-success-result objects, whilst failures are "@BatchPresenceFailureResult@":#batch-presence-failure-result objects. On failure, the promise is rejected with an "@ErrorInfo@":/docs/api/realtime-sdk/types#error-info object.
 
 h2(#related-types). Related types
 
@@ -293,6 +293,8 @@ h3(#stats-type).
 
 h3(#stats-granularity).
   objc,swift: ARTStatsGranularity
+  jsall:      StatsIntervalGranularity
+  csharp:     StatsIntervalGranularity
 
 <%= partial partial_version('types/_stats_granularity') %>
 
@@ -306,3 +308,35 @@ h3(#param).
 
 blang[java].
   <%= partial partial_version('types/_param'), indent: 2, skip_first_indent: true %>
+
+blang[jsall].
+
+  h3(#batch-publish-spec).
+    jsall: BatchPublishSpec
+
+  <%= partial partial_version('types/_batch_publish_spec') %>
+
+  h3(#batch-result).
+    jsall: BatchResult
+
+  <%= partial partial_version('types/_batch_result') %>
+
+  h3(#batch-publish-success-result).
+    jsall: BatchPublishSuccessResult
+
+  <%= partial partial_version('types/_batch_publish_success_result') %>
+
+  h3(#batch-publish-failure-result).
+    jsall: BatchPublishFailureResult
+
+  <%= partial partial_version('types/_batch_publish_failure_result') %>
+
+  h3(#batch-presence-success-result).
+    jsall: BatchPresenceSuccessResult
+
+  <%= partial partial_version('types/_batch_presence_success_result') %>
+
+  h3(#batch-presence-failure-result).
+    jsall: BatchPresenceFailureResult
+
+  <%= partial partial_version('types/_batch_presence_failure_result') %>