diff --git a/assets/docs/configuration/sources/pubsub-full-example.hcl b/assets/docs/configuration/sources/pubsub-full-example.hcl
index 34a0f98b..f478316f 100644
--- a/assets/docs/configuration/sources/pubsub-full-example.hcl
+++ b/assets/docs/configuration/sources/pubsub-full-example.hcl
@@ -8,7 +8,9 @@ source {
     # subscription ID for the pubsub subscription
     subscription_id   = "subscription-id"
 
-    # Maximum concurrent goroutines (lightweight threads) for message processing (default: 50)
+    # This option is deprecated for the pubsub source, and will be changed or removed in the next major release.
+    # Use streaming_pull_goroutines, max_outstanding_messages, and max_outstanding_bytes to configure concurrency instead.
+    # Where streaming_pull_goroutines is set, this option is ignored.
     concurrent_writes = 20
 
     # Maximum number of unprocessed messages (default 1000)