From deb8070479057b6913fcc4a8feb9d8f4571b2faf Mon Sep 17 00:00:00 2001 From: jjpinto Date: Tue, 20 Jan 2026 14:17:34 -0500 Subject: [PATCH] Update NATS Jetstream documentation for clarity Clarified the status of the Jetstream implementation in the documentation, emphasizing its beta status and lack of stability. --- docs/content/pubsubs/nats.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/content/pubsubs/nats.md b/docs/content/pubsubs/nats.md index ffce9c466..83260f9f7 100644 --- a/docs/content/pubsubs/nats.md +++ b/docs/content/pubsubs/nats.md @@ -8,9 +8,10 @@ weight = 90 NATS Jetstream is a data streaming system powered by NATS, and written in the Go programming language. -As of v2.0.2 this middleware will contain a beta implementation in `pkg/jetstream` based on the -[nats.go Jetstream package](https://github.com/nats-io/nats.go/tree/main/jetstream). This implementation is -considered experimental tracking with the upstream client though we target a stable watermill API by v2.1. +As of v2.0.2, this middleware includes an experimental implementation in `pkg/jetstream`, based on the +[nats.go Jetstream package](https://github.com/nats-io/nats.go/tree/main/jetstream). This implementation +remains **beta** and is **not considered a stable API**. It tracks the evolving upstream JetStream client +and currently exposes only a minimal configuration surface. For production use it is recommended to use the pubsub implementations in `pkg/nats` with Jetstream enabled. You can find a fully functional example with NATS JetStream in the [Watermill examples](https://github.com/ThreeDotsLabs/watermill/tree/master/_examples/pubsubs/nats-jetstream).