From 15f80a475da1a65e987eb3111c194266401a1035 Mon Sep 17 00:00:00 2001
From: JJ Brosnan <84038776+jjbrosnan@users.noreply.github.com>
Date: Fri, 26 Sep 2025 14:02:58 -0400
Subject: [PATCH 1/2] CQ

---
 .../assets/reference/faq/blink-ring.gif       |  3 +
 .../community-questions/blink-ring.md         | 68 +++++++++++++++++++
 docs/python/sidebar.json                      |  4 ++
 3 files changed, 75 insertions(+)
 create mode 100644 docs/python/assets/reference/faq/blink-ring.gif
 create mode 100644 docs/python/reference/community-questions/blink-ring.md

diff --git a/docs/python/assets/reference/faq/blink-ring.gif b/docs/python/assets/reference/faq/blink-ring.gif
new file mode 100644
index 00000000000..f2fac90c9ef
--- /dev/null
+++ b/docs/python/assets/reference/faq/blink-ring.gif
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:551121bf1ffa26d0ae62b4305aff2ec1b68d45768e6a65c9b110e31f44bfa8f6
+size 543084
diff --git a/docs/python/reference/community-questions/blink-ring.md b/docs/python/reference/community-questions/blink-ring.md
new file mode 100644
index 00000000000..d2b694880b1
--- /dev/null
+++ b/docs/python/reference/community-questions/blink-ring.md
@@ -0,0 +1,68 @@
+---
+title: "How can I construct a ring table of the first row of the last N update cycles of a blink table?
+sidebar_label: "How can I store the first row of the last N blinks of a table?"
+---
+
+_I have a blink table, from which I want to extract the first row of the last N blinks into a separate ring table. How can I do that?_
+
+The short summary of the answer to this question is:
+
+- Use a [Table listener](../../how-to-guides/table-listeners-python.md) to listen to the source blink table.
+- Use a [Table publisher](../../how-to-guides/table-publisher.md) to publish the first row each update cycle.
+- Convert the result to a ring table.
+
+The following example shows how to do this:
+
+```python skip-test
+from deephaven.stream.table_publisher import table_publisher
+from deephaven.execution_context import get_exec_ctx
+from deephaven.stream import blink_to_append_only
+from deephaven.table_factory import ring_table
+from deephaven.table_listener import listen
+from deephaven.time import to_j_instant
+from deephaven import dtypes as dht
+from deephaven import empty_table
+from deephaven import time_table
+
+ctx = get_exec_ctx()
+
+source = time_table("PT0.2s", blink_table=True).update("X = (double)ii")
+
+
+def on_shutdown():
+    print("Table publisher has been shut down.")
+
+
+result_blink, my_publisher = table_publisher(
+    name="Example", col_defs={"Timestamp": dht.Instant, "X": dht.double}
+)
+
+
+def when_done():
+    my_publisher.publish_failure(RuntimeError("Publisher shut down by user."))
+
+
+def add_table(ts, x_val):
+    with ctx:
+        my_publisher.add(empty_table(1).update(["Timestamp = ts", "X = x_val"]))
+
+
+def listener_function(update, is_replay):
+    added = update.added()
+    first_timestamp = to_j_instant(added["Timestamp"][0])
+    first_x = added["X"][0]
+    add_table(first_timestamp, first_x)
+
+
+handle = listen(source, listener_function)
+
+result = blink_to_append_only(result_blink)
+result_ring = ring_table(result, 10)
+```
+
+![First row of last 10 blinks](../../assets/reference/faq/blink-ring.gif)
+
+This example shows that the solution works, since the `X` column contains only the value `0`, which is the first row on every update cycle.
+
+> [!NOTE]
+> These FAQ pages contain answers to questions about Deephaven Community Core that our users have asked in our [Community Slack](/slack). If you have a question that is not in our documentation, [join our Community](/slack) and we'll be happy to help!
diff --git a/docs/python/sidebar.json b/docs/python/sidebar.json
index 4b648caf87f..d5801a5d8c6 100644
--- a/docs/python/sidebar.json
+++ b/docs/python/sidebar.json
@@ -2678,6 +2678,10 @@
                   {
                     "label": "When should I use `where_in` or `natural_join`?",
                     "path": "reference/community-questions/wherein-vs-naturaljoin.md"
+                  },
+                  {
+                    "label": "How can I capture the first row of the last N updates?",
+                    "path": "reference/community-questions/blink-ring.md"
                   }
                 ]
               },

From d69d95a2938b8575554aa15d671cf44b75d3e523 Mon Sep 17 00:00:00 2001
From: JJ Brosnan <84038776+jjbrosnan@users.noreply.github.com>
Date: Mon, 29 Sep 2025 08:26:56 -0400
Subject: [PATCH 2/2] Update
 docs/python/reference/community-questions/blink-ring.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 docs/python/reference/community-questions/blink-ring.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/python/reference/community-questions/blink-ring.md b/docs/python/reference/community-questions/blink-ring.md
index d2b694880b1..ac558f4ab93 100644
--- a/docs/python/reference/community-questions/blink-ring.md
+++ b/docs/python/reference/community-questions/blink-ring.md
@@ -1,5 +1,5 @@
 ---
-title: "How can I construct a ring table of the first row of the last N update cycles of a blink table?
+title: "How can I construct a ring table of the first row of the last N update cycles of a blink table?"
 sidebar_label: "How can I store the first row of the last N blinks of a table?"
 ---