Skip to content

Commit c07f5e4

Browse files
committed
Appends: note about append on a new attachment, remove note about continuous history not being supported yet
1 parent a52d9aa commit c07f5e4

2 files changed

Lines changed: 2 additions & 4 deletions

File tree

src/pages/docs/messages/annotations.mdx

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,8 +23,6 @@ Annotations can be enabled for a channel or channel namespace with the *Message
2323

2424
<Aside data-type='important'>
2525
When message annotations are enabled, messages are [persisted](/docs/storage-history/storage#all-message-persistence) regardless of whether or not persistence is enabled, in order to support the feature. This may increase your usage since [we charge for persisting messages](https://faqs.ably.com/how-does-ably-count-messages).
26-
27-
[Continuous history](/docs/storage-history/history#continuous-history) features are not supported. Be aware that if you are currently using continuous history and enable annotations, updates, deletes, and appends, continuous history will no longer function.
2826
</Aside>
2927

3028
1. Go to the **Settings** tab of an app in your dashboard.

src/pages/docs/messages/updates-deletes.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -27,8 +27,6 @@ Message updates and deletes can be enabled for a channel or channel namespace wi
2727

2828
<Aside data-type='important'>
2929
When message updates and deletes are enabled, messages are [persisted](/docs/storage-history/storage#all-message-persistence) regardless of whether or not persistence is enabled, in order to support the feature. This may increase your usage since [we charge for persisting messages](https://faqs.ably.com/how-does-ably-count-messages).
30-
31-
[Continuous history](/docs/storage-history/history#continuous-history) features are not yet supported. Be aware that for now, if you are currently using continuous history and enable annotations, updates, deletes, and appends, continuous history will no longer function.
3230
</Aside>
3331

3432
1. Go to the **Settings** tab of an app in your dashboard.
@@ -411,6 +409,8 @@ If you are publishing appends at a high rate, use a [Realtime](/docs/api/realtim
411409

412410
When Ably receives an append, it concatenates the provided data with the current latest version to calculate a full (non-incremental) version of the message. That version (with an action of `message.update`) is then used in contexts like [History](/docs/storage-history/history) and [rewind](/docs/channels/options/rewind), so that when using those APIs, you will always receive complete messages without needing to do any concatenation yourself, and can specify e.g. `rewind=10` to get the most recent 10 full, distinct messages.
413411

412+
The first append you receive for a given message on an attachment is delivered as a fully-aggregated `message.update`, so that you don't need to reach into history to discover the full prior state of the message. You can then just concatenate the payloads of any subsequent `message.append`s for that message onto that first one to get the full payload. Note that Ably may at any time deliver an append as a `message.update` with the full rolled-up payload, so you should always check the `action` field to know whether to concatenate onto the existing payload or replace it.
413+
414414
### Comparison with update
415415

416416
| Aspect | `updateMessage()` | `appendMessage()` |

0 commit comments

Comments
 (0)