ably · mattheworiordan · Mar 8, 2017 · Jan 20, 2017 · Jan 20, 2017 · Jan 20, 2017
diff --git a/content/client-lib-development-guide/features.textile b/content/client-lib-development-guide/features.textile
diff --git a/content/client-lib-development-guide/versions/features-0-8__1-0.diff b/content/client-lib-development-guide/versions/features-0-8__1-0.diff
diff --git a/content/code/authentication/auth-callback.code b/content/code/authentication/auth-callback.code
@@ -23,7 +23,7 @@ $('input#connect').on('click', function() {
 [--- /Javascript ---]
 
 [--- HTML ---]
-<script type="text/javascript" src="//cdn.ably.io/lib/ably.min.js"></script>
+<script type="text/javascript" src="//cdn.ably.io/lib/ably.min-1.js"></script>
 <script src="//jsbin-files.ably.io/js/jquery-1.8.3.min.js"></script>
 <h1>Ably authCallback example</h1>
 

diff --git a/content/code/authentication/basic-auth.code b/content/code/authentication/basic-auth.code
@@ -14,7 +14,7 @@ $('input#connect').on('click', function() {
 [--- /Javascript ---]
 
 [--- HTML ---]
-<script type="text/javascript" src="//cdn.ably.io/lib/ably.min.js"></script>
+<script type="text/javascript" src="//cdn.ably.io/lib/ably.min-1.js"></script>
 <script src="//jsbin-files.ably.io/js/jquery-1.8.3.min.js"></script>
 <h1>Ably Basic Auth Example</h1>
 

diff --git a/content/code/authentication/capabilities.code b/content/code/authentication/capabilities.code
@@ -107,7 +107,7 @@ function scrollBottom() {
 [--- /Javascript ---]
 
 [--- HTML ---]
-<script type="text/javascript" src="//cdn.ably.io/lib/ably.min.js"></script>
+<script type="text/javascript" src="//cdn.ably.io/lib/ably.min-1.js"></script>
 <script src="//jsbin-files.ably.io/js/jquery-1.8.3.min.js"></script>
 <h1>Ably Capabilities Example</h1>
 

diff --git a/content/code/authentication/create-token-request.code b/content/code/authentication/create-token-request.code
@@ -32,7 +32,7 @@ $('input#connect').on('click', function() {
 [--- /Javascript ---]
 
 [--- HTML ---]
-<script type="text/javascript" src="//cdn.ably.io/lib/ably.min.js"></script>
+<script type="text/javascript" src="//cdn.ably.io/lib/ably.min-1.js"></script>
 <script src="//jsbin-files.ably.io/js/jquery-1.8.3.min.js"></script>
 <h1>Ably Signed Token Request Example</h1>
 

diff --git a/content/code/authentication/request-token.code b/content/code/authentication/request-token.code
@@ -28,7 +28,7 @@ $('input#connect').on('click', function() {
 [--- /Javascript ---]
 
 [--- HTML ---]
-<script type="text/javascript" src="//cdn.ably.io/lib/ably.min.js"></script>
+<script type="text/javascript" src="//cdn.ably.io/lib/ably.min-1.js"></script>
 <script src="//jsbin-files.ably.io/js/jquery-1.8.3.min.js"></script>
 <h1>Ably Request Token Example</h1>
 

diff --git a/content/code/client-lib-development-guide/example.code b/content/code/client-lib-development-guide/example.code
@@ -7,7 +7,7 @@ ably.connection.on('connected', function() {
 [--- /Javascript ---]
 
 [--- HTML ---]
-<script type="text/javascript" src="//cdn.ably.io/lib/ably.min.js"></script>
+<script type="text/javascript" src="//cdn.ably.io/lib/ably.min-1.js"></script>
 <h1>Ably Quickstart Connect Example</h1>
 [--- /HTML ---]
 

diff --git a/content/code/quick-start-guide/connect.code b/content/code/quick-start-guide/connect.code
@@ -7,7 +7,7 @@ ably.connection.on('connected', function() {
 [--- /Javascript ---]
 
 [--- HTML ---]
-<script type="text/javascript" src="//cdn.ably.io/lib/ably.min.js"></script>
+<script type="text/javascript" src="//cdn.ably.io/lib/ably.min-1.js"></script>
 <script src="//jsbin-files.ably.io/js/jquery-1.8.3.min.js"></script>
 <h1>Ably Quickstart Connect Example</h1>
 <div id="message" style="color: green"></div>

diff --git a/content/code/quick-start-guide/send-message.code b/content/code/quick-start-guide/send-message.code
@@ -17,7 +17,7 @@ $('input[type=button]').on('click', function() {
 
 [--- HTML ---]
 <script type="text/javascript" src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.3/jquery.min.js"></script>
-<script type="text/javascript" src="//cdn.ably.io/lib/ably.min.js"></script>
+<script type="text/javascript" src="//cdn.ably.io/lib/ably.min-1.js"></script>
 <h1>Ably Quickstart Publish &amp; Subscribe Example</h1>
 
 <input type="button" value="Connecting...">

diff --git a/content/code/reactor/webhook-hmac-sha-256.code b/content/code/reactor/webhook-hmac-sha-256.code
@@ -26,7 +26,7 @@ $('#check-hmac-btn').on('click', function() {
   <script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.3/jquery.min.js"></script>
   <script src="//cdnjs.cloudflare.com/ajax/libs/crypto-js/3.1.2/rollups/hmac-sha256.js"></script>
   <script src="//cdnjs.cloudflare.com/ajax/libs/crypto-js/3.1.2/components/enc-base64.js"></script>
-  <script src="//cdn.ably.io/lib/ably.js"></script>
+  <script src="//cdn.ably.io/lib/ably-1.js"></script>
 </head>
 <body>
   <h1><a href="https://www.ably.io" target="_blank"><img src="/images/favicon.png">Ably realtime</a> WebHook HMAC validation example</h1>

diff --git a/content/code/realtime/auth-client-id.code b/content/code/realtime/auth-client-id.code
@@ -47,7 +47,7 @@ function show(status, color) {
 [--- /Javascript ---]
 
 [--- HTML ---]
-<script type="text/javascript" src="//cdn.ably.io/lib/ably.min.js"></script>
+<script type="text/javascript" src="//cdn.ably.io/lib/ably.min-1.js"></script>
 <script src="//jsbin-files.ably.io/js/jquery-1.8.3.min.js"></script>
 <h1>Ably Auth Client ID Example</h1>
 

diff --git a/content/code/realtime/auth-token-callback.code b/content/code/realtime/auth-token-callback.code
@@ -29,7 +29,7 @@ function show(status, color) {
 [--- /Javascript ---]
 
 [--- HTML ---]
-<script type="text/javascript" src="//cdn.ably.io/lib/ably.min.js"></script>
+<script type="text/javascript" src="//cdn.ably.io/lib/ably.min-1.js"></script>
 <script src="//jsbin-files.ably.io/js/jquery-1.8.3.min.js"></script>
 <h1>Ably Auth Token Example</h1>
 

diff --git a/content/code/realtime/channel-encrypted.code b/content/code/realtime/channel-encrypted.code
@@ -48,7 +48,7 @@ function arrayBufferToHex(arrayBuffer) {
 [--- /Javascript ---]
 
 [--- HTML ---]
-<script type="text/javascript" src="//cdn.ably.io/lib/ably.min.js"></script>
+<script type="text/javascript" src="//cdn.ably.io/lib/ably.min-1.js"></script>
 <script src="//jsbin-files.ably.io/js/jquery-1.8.3.min.js"></script>
 <h1>Ably Encrypted Channel Example</h1>
 

diff --git a/content/code/realtime/channel-history-until-attach.code b/content/code/realtime/channel-history-until-attach.code
@@ -59,7 +59,7 @@ $('input#history').on('click', attachAndGetHistory);
 [--- /Javascript ---]
 
 [--- HTML ---]
-<script type="text/javascript" src="//cdn.ably.io/lib/ably.min.js"></script>
+<script type="text/javascript" src="//cdn.ably.io/lib/ably.min-1.js"></script>
 <script src="//jsbin-files.ably.io/js/jquery-1.8.3.min.js"></script>
 <h1>Ably Channel History Example</h1>
 

diff --git a/content/code/realtime/channel-history.code b/content/code/realtime/channel-history.code
@@ -46,7 +46,7 @@ $('input#history').on('click', getHistory);
 [--- /Javascript ---]
 
 [--- HTML ---]
-<script type="text/javascript" src="//cdn.ably.io/lib/ably.min.js"></script>
+<script type="text/javascript" src="//cdn.ably.io/lib/ably.min-1.js"></script>
 <script src="//jsbin-files.ably.io/js/jquery-1.8.3.min.js"></script>
 <h1>Ably Channel History Example</h1>
 

diff --git a/content/code/realtime/channel-implicit.code b/content/code/realtime/channel-implicit.code
@@ -26,7 +26,7 @@ function show(status, color) {
 [--- /Javascript ---]
 
 [--- HTML ---]
-<script type="text/javascript" src="//cdn.ably.io/lib/ably.min.js"></script>
+<script type="text/javascript" src="//cdn.ably.io/lib/ably.min-1.js"></script>
 <script src="//jsbin-files.ably.io/js/jquery-1.8.3.min.js"></script>
 <h1>Ably Implicit Attach Channel Example</h1>
 

diff --git a/content/code/realtime/channel-publish.code b/content/code/realtime/channel-publish.code
@@ -24,7 +24,7 @@ function show(status, color) {
 [--- /Javascript ---]
 
 [--- HTML ---]
-<script type="text/javascript" src="//cdn.ably.io/lib/ably.min.js"></script>
+<script type="text/javascript" src="//cdn.ably.io/lib/ably.min-1.js"></script>
 <script src="//jsbin-files.ably.io/js/jquery-1.8.3.min.js"></script>
 <h1>Ably Channel Example</h1>
 

diff --git a/content/code/realtime/channel-states.code b/content/code/realtime/channel-states.code
@@ -24,7 +24,7 @@ function logState(currentState) {
 
 [--- HTML ---]
 <script type="text/javascript" src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.3/jquery.min.js"></script>
-<script type="text/javascript" src="//cdn.ably.io/lib/ably.min.js"></script>
+<script type="text/javascript" src="//cdn.ably.io/lib/ably.min-1.js"></script>
 <h1>Ably Realtime Channel States Example</h1>
 
 <h2>Channel state history</h2>

diff --git a/content/code/realtime/channel.code b/content/code/realtime/channel.code
@@ -29,7 +29,7 @@ function show(status, color) {
 [--- /Javascript ---]
 
 [--- HTML ---]
-<script type="text/javascript" src="//cdn.ably.io/lib/ably.min.js"></script>
+<script type="text/javascript" src="//cdn.ably.io/lib/ably.min-1.js"></script>
 <script src="//jsbin-files.ably.io/js/jquery-1.8.3.min.js"></script>
 <h1>Ably Channel Example</h1>
 

diff --git a/content/code/realtime/connection-states.code b/content/code/realtime/connection-states.code
@@ -22,7 +22,7 @@ function logState(currentState, stateChangeObj) {
 
 [--- HTML ---]
 <script type="text/javascript" src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.3/jquery.min.js"></script>
-<script type="text/javascript" src="//cdn.ably.io/lib/ably.min.js"></script>
+<script type="text/javascript" src="//cdn.ably.io/lib/ably.min-1.js"></script>
 <h1>Ably Realtime Connection States Example</h1>
 
 <h2>Connection state history</h2>

diff --git a/content/code/realtime/connection.code b/content/code/realtime/connection.code
@@ -22,7 +22,7 @@ function show(status, color) {
 [--- /Javascript ---]
 
 [--- HTML ---]
-<script type="text/javascript" src="//cdn.ably.io/lib/ably.min.js"></script>
+<script type="text/javascript" src="//cdn.ably.io/lib/ably.min-1.js"></script>
 <script src="//jsbin-files.ably.io/js/jquery-1.8.3.min.js"></script>
 <h1>Ably Connection Example</h1>
 

diff --git a/content/code/realtime/presence-events.code b/content/code/realtime/presence-events.code
@@ -42,7 +42,7 @@ function append(message, color) {
 [--- /Javascript ---]
 
 [--- HTML ---]
-<script type="text/javascript" src="//cdn.ably.io/lib/ably.min.js"></script>
+<script type="text/javascript" src="//cdn.ably.io/lib/ably.min-1.js"></script>
 <script src="//jsbin-files.ably.io/js/jquery-1.8.3.min.js"></script>
 <h1>Ably Presence Example</h1>
 

diff --git a/content/code/realtime/presence-multiple-client-id.code b/content/code/realtime/presence-multiple-client-id.code
@@ -29,7 +29,7 @@ function show(status, color) {
 [--- /Javascript ---]
 
 [--- HTML ---]
-<script type="text/javascript" src="//cdn.ably.io/lib/ably.min.js"></script>
+<script type="text/javascript" src="//cdn.ably.io/lib/ably.min-1.js"></script>
 <script src="//jsbin-files.ably.io/js/jquery-1.8.3.min.js"></script>
 <h1>Ably Presence Example</h1>
 

diff --git a/content/code/realtime/presence-simple.code b/content/code/realtime/presence-simple.code
@@ -24,7 +24,7 @@ function show(status, color) {
 [--- /Javascript ---]
 
 [--- HTML ---]
-<script type="text/javascript" src="//cdn.ably.io/lib/ably.min.js"></script>
+<script type="text/javascript" src="//cdn.ably.io/lib/ably.min-1.js"></script>
 <script src="//jsbin-files.ably.io/js/jquery-1.8.3.min.js"></script>
 <h1>Ably Presence Example</h1>
 

diff --git a/content/code/realtime/stats.code b/content/code/realtime/stats.code
@@ -44,7 +44,7 @@ function show(status, color) {
 [--- /Javascript ---]
 
 [--- HTML ---]
-<script type="text/javascript" src="//cdn.ably.io/lib/ably.min.js"></script>
+<script type="text/javascript" src="//cdn.ably.io/lib/ably.min-1.js"></script>
 <script src="//jsbin-files.ably.io/js/jquery-1.8.3.min.js"></script>
 <h1>Ably Stats Example</h1>
 

diff --git a/content/code/rest/channel-history.code b/content/code/rest/channel-history.code
@@ -46,7 +46,7 @@ $('input#history').on('click', getHistory);
 [--- /Javascript ---]
 
 [--- HTML ---]
-<script type="text/javascript" src="//cdn.ably.io/lib/ably.min.js"></script>
+<script type="text/javascript" src="//cdn.ably.io/lib/ably.min-1.js"></script>
 <script src="//jsbin-files.ably.io/js/jquery-1.8.3.min.js"></script>
 <h1>Ably REST History Example</h1>
 

diff --git a/content/code/rest/channel-publish.code b/content/code/rest/channel-publish.code
@@ -20,7 +20,7 @@ function show(status, color) {
 [--- /Javascript ---]
 
 [--- HTML ---]
-<script type="text/javascript" src="//cdn.ably.io/lib/ably.min.js"></script>
+<script type="text/javascript" src="//cdn.ably.io/lib/ably.min-1.js"></script>
 <script src="//jsbin-files.ably.io/js/jquery-1.8.3.min.js"></script>
 <h1>Ably REST Publish Example</h1>
 

diff --git a/content/code/rest/publish-on-behalf-of-client.code b/content/code/rest/publish-on-behalf-of-client.code
@@ -51,7 +51,7 @@ function show(status, color) {
 [--- /Javascript ---]
 
 [--- HTML ---]
-<script type="text/javascript" src="//cdn.ably.io/lib/ably.min.js"></script>
+<script type="text/javascript" src="//cdn.ably.io/lib/ably.min-1.js"></script>
 <script src="//jsbin-files.ably.io/js/jquery-1.8.3.min.js"></script>
 <h1>Ably: Publishing over REST on behalf of a Realtime client example</h1>
 

diff --git a/content/code/rest/stats.code b/content/code/rest/stats.code
@@ -40,7 +40,7 @@ function show(status, color) {
 [--- /Javascript ---]
 
 [--- HTML ---]
-<script type="text/javascript" src="//cdn.ably.io/lib/ably.min.js"></script>
+<script type="text/javascript" src="//cdn.ably.io/lib/ably.min-1.js"></script>
 <script src="//jsbin-files.ably.io/js/jquery-1.8.3.min.js"></script>
 <h1>Ably Stats Example</h1>
 

diff --git a/content/code/website-examples/angular-todo.code b/content/code/website-examples/angular-todo.code
@@ -110,7 +110,7 @@ function toDoEntry() {
 <head>
   <script src="//jsbin-files.ably.io/js/jquery-1.8.3.min.js"></script>
   <script src="//jsbin-files.ably.io/js/underscore-min.js"></script>
-  <script type="text/javascript" src="//cdn.ably.io/lib/ably.min.js"></script>
+  <script type="text/javascript" src="//cdn.ably.io/lib/ably.min-1.js"></script>
   <script src="//ajax.googleapis.com/ajax/libs/angularjs/1.3.2/angular.min.js"></script>
   <meta charset=utf-8 />
 </head>

diff --git a/content/code/website-examples/backbone-todo.code b/content/code/website-examples/backbone-todo.code
@@ -105,7 +105,7 @@ $(function() {
     <script src="//jsbin-files.ably.io/js/underscore-min.js"></script>
     <script src="//jsbin-files.ably.io/js/backbone-min.js"></script>
     <script src="//jsbin-files.ably.io/js/moment.min.js"></script>
-    <script type="text/javascript" src="//cdn.ably.io/lib/ably.min.js"></script>
+    <script type="text/javascript" src="//cdn.ably.io/lib/ably.min-1.js"></script>
     <meta charset=utf-8 />
   </head>
 

diff --git a/content/code/website-examples/ember-todo.code b/content/code/website-examples/ember-todo.code
@@ -113,7 +113,7 @@ App.CreateToDoButtonView = Ember.Button.extend({
     <script src="//jsbin-files.ably.io/js/jquery-1.8.3.min.js"></script>
     <script src="//jsbin-files.ably.io/js/ember-0.9.8.1.min.js"></script>
     <script src="//jsbin-files.ably.io/js/moment.min.js"></script>
-    <script type="text/javascript" src="//cdn.ably.io/lib/ably.min.js"></script>
+    <script type="text/javascript" src="//cdn.ably.io/lib/ably.min-1.js"></script>
     <meta charset=utf-8 />
   </head>
 

diff --git a/content/code/website-examples/home-page.code b/content/code/website-examples/home-page.code
@@ -16,7 +16,7 @@ function show(status) {
 [--- /Javascript ---]
 
 [--- HTML ---]
-<script type="text/javascript" src="//cdn.ably.io/lib/ably.min.js"></script>
+<script type="text/javascript" src="//cdn.ably.io/lib/ably.min-1.js"></script>
 <script src="//jsbin-files.ably.io/js/jquery-1.8.3.min.js"></script>
 <h1>Ably: Simple API Example</h1>
 

diff --git a/content/code/website-examples/simple-chat.code.erb b/content/code/website-examples/simple-chat.code.erb
@@ -44,7 +44,7 @@ $(function() {
   <head>
     <script src="//jsbin-files.ably.io/js/jquery-1.8.3.min.js"></script>
     <script src="//jsbin-files.ably.io/js/moment.min.js"></script>
-    <script type="text/javascript" src="//cdn.ably.io/lib/ably.min.js"></script>
+    <script type="text/javascript" src="//cdn.ably.io/lib/ably.min-1.js"></script>
     <meta charset=utf-8 />
   </head>
   <body>

diff --git a/content/general/queues.textile b/content/general/queues.textile
@@ -112,7 +112,7 @@ bc[sh]. amqp-consume --queue-name [Name] \
   --host [Server endpoint host] --port [Server endpoint port] \
   --ssl --vhost shared --creds [your API key]
 
-Whenever a message is published to the queue you are subscribing to, the amqp-consume tool will output the message details such as:
+Whenever a message is published to the queue you are subscribing to, the @amqp-consume@ tool will output the message details such as:
 
 ```[sh]
 Message received
@@ -130,13 +130,18 @@ Data: {
   "messageId":"vjzxPR-XK3:3",
   "messages":[
     {
-      "id":"vjzxPR-XK3:3:0","name":"event","connectionId":"vjzxPR-XK3",
-      "timestamp":1485914937909,"data":"payload"
+      "id":"vjzxPR-XK3:3:0",
+      "name":"event",
+      "connectionId":"vjzxPR-XK3",
+      "timestamp":1485914937909,
+      "data":"payload"
     }
   ]
 }
 ```
 
+_Please note that the @messages@ attribute is an @Array@ so that future envelope options may allow messages to be bundled into a single envelope ("WebHooks":/general/webhooks currently bundle messages). However, with the current queue rule design, an envelope will only ever contain one message._
+
 h3. Consuming messages from queues
 
 Consuming messages from Ably Reactor Message Queues is mostly the same as consuming from any other queue supporting AMQP or STOMP protocols.  However, there a few tips below to avoid common pitfalls.
@@ -176,6 +181,11 @@ amqp.connect(url, (err, conn) => {
     /* Wait for messages published to the Ably Reactor queue */
     ch.consume('UATwBQ:example-queue', (item) => {
       let decodedEnvelope = JSON.parse(item.content)
+
+      /* The envelope messages attribute will only contain one message. However,
+         in future versions, we may allow optional bundling of messages into a
+         single queue message and as such this attribute is an Array to support
+         that in future */
       let messages = Ably.Realtime.Message.fromEncodedArray(decodedEnvelope.messages)
       messages.forEach((message) => {
         actionMessage(message)
@@ -245,6 +255,11 @@ Stompit.connect(connectOptions, (error, client) => {
       if (err) { return handleError(err) }
 
       let decodedEnvelope = JSON.parse(item.content)
+
+      /* The envelope messages attribute will only contain one message. However,
+         in future versions, we may allow optional bundling of messages into a
+         single queue message and as such this attribute is an Array to support
+         that in future */
       let messages = Ably.Realtime.Message.fromEncodedArray(decodedEnvelope.messages)
       messages.forEach((message) => {
         actionMessage(message)
@@ -299,7 +314,7 @@ h5. Enveloped message example
 }
 ```
 
-Please note that the @messages@ attribute is an array of messages so that future envelope options may allow messages to be bundled into a single envelope (like "WebHooks":/general/webhooks). However, with the current queue rule design, an envelope will only ever contain one message.
+_Please note that the @messages@ attribute is an @Array@ so that future envelope options may allow messages to be bundled into a single envelope ("WebHooks":/general/webhooks currently bundle messages). However, with the current queue rule design, an envelope will only ever contain one message._
 
 h5. Non-enveloped message example
 
@@ -348,7 +363,7 @@ h5. Enveloped presence message example
 }
 ```
 
-Please note that the @presence@ attribute is an array of presence messages so that infuture envelope options may allow presence messages to be bundled into a single envelope (like "WebHooks":/general/webhooks). However, with the current queue rule design, an envelope will only ever contain one presence message.
+_Please note that the @presence@ attribute is an @Array@ so that future envelope options may allow presence messages to be bundled into a single envelope ("WebHooks":/general/webhooks currently bundle messages). However, with the current queue rule design, an envelope will only ever contain one presence message._
 
 h5. Non-enveloped presence message example