fixup! annotations: restructure annotations page to split summaries and individual events

Author: m-hulbert

src/pages/docs/messages/annotations.mdx

@@ -421,6 +421,10 @@ await channel.annotations.publish(message.serial, {
 
 Subscribe to individual annotation events using the `annotations.subscribe()` method on a channel. To subscribe to individual annotations, you must request the `ANNOTATION_SUBSCRIBE` [mode](/docs/channels/options#modes).
 
+<Aside data-type='note'>
+When you provide an explicit `modes` property for a channel, you override the set of [default modes](/docs/channels/options#modes) used for that channel. It is likely that you will be using features other than just annotations, so ensure that you also include the other `modes` that you require.
+</Aside>
+
 Annotations delivered to the `annotations.subscribe()` listener will have an `action` of `annotation.create` or `annotation.delete`.
 
 <Code>
@@ -432,7 +436,7 @@ const realtime = new Ably.Realtime({ key: '{{API_KEY}}', clientId: 'my-client-id
 // Create a channel in a namespace called `annotations`
 // which has message annotations enabled.
 // Specify the ANNOTATION_SUBSCRIBE mode to enable annotation subscriptions.
-const channel = realtime.channels.get('annotations:example', { modes: ['ANNOTATION_SUBSCRIBE'] });
+const channel = realtime.channels.get('annotations:example', { modes: ['ANNOTATION_SUBSCRIBE', ... /* all other modes you need, such as MESSAGE_SUBSCRIBE */] });
 
 await channel.annotations.subscribe((annotation) => {
   if (annotation.action === 'annotation.create') {