Docs Originality Update - Batch #9 (#307)

* Docs Originality Update - Batch #9

* dragonfly prompt

* adjust XACK

* adjust XINFO GROUPS

* adjust XINFO STREAM

* adjust XLEN

* adjust XRANGE

* adjust XRANGE x02

* minor

* adjust XPENDING

* adjust XREAD

* adjust XREADGROUP

* adjust XREVRANGE

* adjust XSETID

* add back time complexity & acl categories for streams

* use the same prompt for strings

* adjust XTRIM

---------

Co-authored-by: xf10w <[email protected]>
Co-authored-by: Joe Zhou <[email protected]>

Author: craftizard

docs/command-reference/stream/xack.md

@@ -1,5 +1,5 @@
 ---
-description:  Learn how to use Redis XACK to acknowledge the processing of a message from a stream by a consumer.
+description: Learn how to use Redis XACK to acknowledge the processing of a message from a stream by a consumer.
 ---
 
 import PageTitle from '@site/src/components/PageTitle';
@@ -8,26 +8,102 @@ import PageTitle from '@site/src/components/PageTitle';
 
 <PageTitle title="Redis XACK Command (Documentation) | Dragonfly" />
 
+## Introduction
+
+In Dragonfly, as well as in Redis and Valkey, the `XACK` command is used to acknowledge one or more messages in a stream that have been successfully processed.
+It is useful in stream processing systems where consumers must signal that a message has been handled, helping to manage message delivery and retention more efficiently within a consumer group.
+After successfully processing a message, a consumer should call `XACK` to prevent reprocessing and remove the message from the Pending Entries List (PEL).
+
 ## Syntax
 
-    XACK key group id [id ... ]
+```shell
+XACK key group id [id ...]
+```
 
-**Time complexity:** O(1) for each message ID processed.
+- **Time complexity:** O(1) for each message ID processed.
+- **ACL categories:** @write, @stream, @fast
 
-**ACL categories:** @write, @stream, @fast
+## Parameter Explanations
 
-**XACK** command acknowledges one or more messages by removing the messages from the pending entries list (PEL) of the specified consumer stream group. A message is pending, and as such stored inside the PEL, when it was delivered to some consumer, normally as a side effect of calling XREADGROUP, or when a consumer took ownership of a message calling XCLAIM. The pending message was delivered to some consumer but the server is yet not sure it was processed at least once. So new calls to XREADGROUP to grab the messages history for a consumer (for instance using an ID of 0), will return such message. Similarly the pending message will be listed by the XPENDING command, that inspects the PEL. Once a consumer successfully processes a message, it should call **XACK** so that such message does not get processed again, and as a side effect, the PEL entry about this message is also purged, releasing memory from the Dragonfly server.
+- `key`: The name of the stream.
+- `group`: The name of the consumer group.
+- `id`: The ID of the message to acknowledge. Multiple IDs can be specified.
 
+## Return Values
 
-## Return
+- The command returns an integer indicating the number of messages that were successfully acknowledged.
+- Message IDs that are not part of the PEL (i.e., already been acknowledged) will not be considered successful acknowledgments.
+- If the stream or the consumer group does not exist, the command simply returns `0`.
 
-[Integer reply](https://redis.io/docs/reference/protocol-spec/#integers), specifically:
+## Code Examples
 
-The command returns the number of messages successfully acknowledged. Certain message IDs may no longer be part of the PEL (for example because they have already been acknowledged), and XACK will not count them as successfully acknowledged.
+### Basic Acknowledgement Example
 
-## Examples
+Acknowledge a single message that has been processed:
 
 ```shell
-dragonfly> XACK mystream mygroup 1526569495631-0
+dragonfly$> XADD mystream * name Alice age 20
+"1609097574170-0"
+
+dragonfly$> XGROUP CREATE mystream mygroup 0 MKSTREAM
+OK
+
+dragonfly$> XREADGROUP GROUP mygroup consumer-1 COUNT 1 STREAMS mystream >
+1) 1) "mystream"
+   2) 1) 1) "1609097574170-0"
+         2) 1) "name"
+            2) "Alice"
+            3) "age"
+            4) "20"
+
+dragonfly$> XACK mystream mygroup "1609097574170-0"
 (integer) 1
 ```
+
+### Acknowledging Multiple Messages
+
+Acknowledge multiple messages after processing:
+
+```shell
+dragonfly$> XADD mystream * name Bob age 25
+"1609097574171-0"
+
+dragonfly$> XADD mystream * name Charlie age 30
+"1609097574172-0"
+
+# The consumer reads the 2 new messages.
+dragonfly$> XREADGROUP GROUP mygroup consumer-1 COUNT 2 STREAMS mystream >
+# ...
+
+# Acknowledge the 2 messages for the consumer group.
+dragonfly$> XACK mystream mygroup "1609097574171-0" "1609097574172-0"
+(integer) 2
+```
+
+### Handling Non-existent IDs
+
+Acknowledge attempt on a non-existent message ID:
+
+```shell
+dragonfly$> XACK mystream mygroup "1609097574173-0"
+(integer) 0  # No acknowledgment since the ID does not exist.
+```
+
+## Best Practices
+
+- Use `XACK` to signal message processing completion to avoid reprocessing and free up resources.
+- Implement proper error handling to manage message IDs that may no longer exist or are not yet acknowledged.
+
+## Common Mistakes
+
+- Attempting to acknowledge messages using IDs that were never read by the group.
+
+## FAQs
+
+### What happens if the message ID is not found?
+
+If the message ID does not exist in the pending entries list of the consumer group, `XACK` returns `0`.
+
+### Can `XACK` be used for automatic acknowledgement?
+
+No, `XACK` requires explicit calls to acknowledge messages after successful processing by consumers.

docs/command-reference/stream/xadd.md

@@ -19,6 +19,9 @@ Streams are data structures that enable storing and processing ordered logs of e
 XADD key [<MAXLEN | MINID> [~ | =] threshold] <* | id> field value [field value ...]
 ```
 
+- **Time complexity:** O(1) when adding a new entry, O(N) when trimming where N being the number of entries evicted.
+- **ACL categories:** @write, @stream, @fast
+
 ## Parameter Explanations
 
 - `key`: The key of the stream where the entry will be appended.

docs/command-reference/stream/xautoclaim.md

@@ -21,6 +21,9 @@ which is particularly useful in scenarios where message processing needs to be r
 XAUTOCLAIM key group consumer min-idle-time start [COUNT count] [JUSTID]
 ```
 
+- **Time complexity:** O(1) if `COUNT` is small.
+- **ACL categories:** @write, @stream, @fast
+
 ## Parameter Explanations
 
 - `key`: The key of the stream.

docs/command-reference/stream/xclaim.md

@@ -20,6 +20,9 @@ XCLAIM key group consumer min-idle-time id [id ...] [IDLE ms] [TIME ms-unix-time
        [RETRYCOUNT count] [FORCE] [JUSTID]
 ```
 
+- **Time complexity:** O(log N) with N being the number of messages in the pending entries list (PEL) of the consumer group.
+- **ACL categories:** @write, @stream, @fast
+
 ## Parameter Explanations
 
 - `key`: The key of the stream.

docs/command-reference/stream/xdel.md

@@ -19,6 +19,9 @@ This command is particularly useful for managing data in stream-like structures
 XDEL key ID [ID ...]
 ```
 
+- **Time complexity:** O(1) for each single item to delete in the stream, regardless of the stream size.
+- **ACL categories:** @write, @stream, @fast
+
 ## Parameter Explanations
 
 - `key`: The key of the stream from which entries are to be deleted.

docs/command-reference/stream/xgroup-create.md

@@ -20,6 +20,9 @@ This command is essential for managing distributed message processing systems wh
 XGROUP CREATE key group <id | $> [MKSTREAM]
 ```
 
+- **Time complexity:** O(1)
+- **ACL categories:** @write, @stream, @slow
+
 ## Parameter Explanations
 
 - `key`: The key name of the stream.

docs/command-reference/stream/xgroup-createconsumer.md

@@ -19,6 +19,9 @@ This command is part of the streams data type which facilitates managing consume
 XGROUP CREATECONSUMER key group consumer
 ```
 
+- **Time complexity:** O(1)
+- **ACL categories:** @write, @stream, @slow
+
 ## Parameter Explanations
 
 - `key`: The key of the stream for which the consumer is being created.

docs/command-reference/stream/xgroup-delconsumer.md

@@ -21,6 +21,9 @@ Therefore, be sure to claim or acknowledge any pending messages before removing
 XGROUP DELCONSUMER key group consumer
 ```
 
+- **Time complexity:** O(1)
+- **ACL categories:** @write, @stream, @slow
+
 ## Parameter Explanations
 
 - `key`: The key of the stream.

docs/command-reference/stream/xgroup-destroy.md

@@ -21,6 +21,9 @@ Use this command only when absolutely necessary.**
 XGROUP DESTROY key group
 ```
 
+- **Time complexity:** O(N) where N is the number of entries in the group's pending entries list (PEL).
+- **ACL categories:** @write, @stream, @slow
+
 ## Parameter Explanations
 
 - `key`: The name of the stream from which the consumer group will be deleted.

docs/command-reference/stream/xgroup-setid.md

@@ -19,6 +19,9 @@ This command is beneficial when you need to reprocess messages or adjust a consu
 XGROUP SETID key group <id | $>
 ```
 
+- **Time complexity:** O(1)
+- **ACL categories:** @write, @stream, @slow
+
 ## Parameter Explanations
 
 - `key`: The key of the stream.