Add annotations docs

Author: mschristensen

content/partials/core-features/_authentication_capabilities.textile

@@ -5,6 +5,8 @@ The following capability operations are available for API keys and issued tokens
 - presence := can register presence on a channel (enter, update and leave)
 - object-subscribe := can subscribe to updates to objects on a channel
 - object-publish := can update objects on a channel
+- annotation-subscribe := can subscribe to individual annotations on a channel
+- annotation-publish := can publish annotations to messages on a channel
 - history := can retrieve message and presence state history on channels
 - stats := can retrieve current and historical usage statistics for an app
 - push-subscribe := can subscribe devices for push notifications

src/data/nav/pubsub.ts

@@ -195,6 +195,10 @@ export default {
           name: 'Message batching',
           link: '/docs/messages/batch',
         },
+        {
+          name: 'Message annotations',
+          link: '/docs/messages/annotations',
+        },
       ],
     },
     {

src/pages/docs/auth/capabilities.mdx

@@ -40,6 +40,8 @@ The following capability operations are available for API keys and issued tokens
 | **presence** | Can register presence on a channel (enter, update and leave) |
 | **object-subscribe** | Can subscribe to updates to objects on a channel |
 | **object-publish** | Can update objects on a channel |
+| **annotation-subscribe** | Can subscribe to individual annotations on a channel |
+| **annotation-publish** | Can publish annotations to messages on a channel |
 | **history** | Can retrieve message and presence state history on channels |
 | **stats** | Can retrieve current and historical usage statistics for an app |
 | **push-subscribe** | Can subscribe devices for push notifications |

src/pages/docs/channels/index.mdx

@@ -200,6 +200,7 @@ The channel rules related to enabling features are:
 | Push notifications enabled | If checked, publishing messages with a push payload in the `extras` field is permitted. This triggers the delivery of a [Push Notification](/docs/push) to devices registered for push on the channel. |
 | Server-side batching | If enabled, messages are grouped into batches before being sent to subscribers. [Server-side batching](/docs/messages/batch#server-side) reduces the overall message count, lowers costs, and mitigates the risk of hitting rate limits during high-throughput scenarios. |
 | Message conflation | If enabled, messages are aggregated over a set period of time and evaluated against a conflation key. All but the latest message for each conflation key value will be discarded, and the resulting message, or messages, will be delivered to subscribers as a single batch once the period of time elapses. [Message conflation](/docs/messages#conflation) reduces costs in high-throughput scenarios by removing redundant and outdated messages. |
+| Message annotations, updates, and deletes | If enabled, allows message "annotations":/docs/annotations to be used, as well as updates and deletes to be published to messages. Note that these features are currently Experimental and its features are still in development and subject to change. When this feature is enabled, messages will be "persisted":/docs/storage-history/storage#all-message-persistence (necessary in order from them later be annotated or updated), and "continuous history":/docs/storage-history/history#continuous-history features will unfortunately not work (yet).
 
 To set a channel rule in the Ably dashboard:
 

src/pages/docs/channels/options/index.mdx

@@ -438,6 +438,8 @@ The available set of channel mode flags are:
 | `PRESENCE` | Can register presence on the channel. | Yes |
 | `OBJECT_PUBLISH` | Can update objects on the channel. | No |
 | `OBJECT_SUBSCRIBE` | Can subscribe to receive updates to objects on the channel. | No |
+| `ANNOTATION_PUBLISH` | Can publish annotations to messages on the channel. | Yes |
+| `ANNOTATION_SUBSCRIBE` | Can subscribe to individual annotations on the channel. | No |
 
 The set of modes available to a client is determined by the set of [capabilities](/docs/auth/capabilities) granted by their token or API key.
 
@@ -450,6 +452,8 @@ The modes granted by each capability are:
 | `presence` | `PRESENCE` |
 | `object-subscribe` | `OBJECT_SUBSCRIBE` |
 | `object-publish` | `OBJECT_PUBLISH` |
+| `annotation-publish` | `ANNOTATION_PUBLISH` |
+| `annotation-subscribe` | `ANNOTATION_SUBSCRIBE` |
 
 The actual modes assigned to a client will be the **intersection** of the requested `modes` and the modes available to the client according to its capabilities. For example, a client with the `subscribe` capability which explicitly requests `SUBSCRIBE` and `PUBLISH` modes will be assigned only the `SUBSCRIBE` mode.