docs: Documentation improvements for the Publisher service

Google APIs · copybara-github · commit 526dfad7d4b5 · 2025-03-04T16:46:48.000-08:00
PiperOrigin-RevId: 733511393
diff --git a/google/cloud/eventarc/publishing/v1/eventarcpublishing_v1.yaml b/google/cloud/eventarc/publishing/v1/eventarcpublishing_v1.yaml
@@ -13,11 +13,11 @@ documentation:
   overview: |-
     The Eventarc Publishing API allows services to define and raise events
     which are routed based on the filtering configured through an Eventarc
-    trigger. The code that raises these events can run on Google Cloud compute
-    platforms or in other cloud environments. Eventarc acts as an intermediary
-    between producers and consumers of these events, asynchronously delivering
-    events, and supporting the orchestration of these decoupled
-    services.\n\n\n\n\n\n\n\n
+    Standard trigger or Eventarc Advanced enrollment. The code that raises
+    these events can run on Google Cloud compute platforms or in other cloud
+    environments. Eventarc acts as an intermediary between producers and
+    consumers of these events, asynchronously delivering events, and
+    supporting the orchestration of these decoupled services.\n\n\n\n\n\n\n\n
 
 authentication:
   rules:
diff --git a/google/cloud/eventarc/publishing/v1/publisher.proto b/google/cloud/eventarc/publishing/v1/publisher.proto
@@ -44,16 +44,21 @@ option ruby_package = "Google::Cloud::Eventarc::Publishing::V1";
 // A subscriber is a GCP customer interested in receiving events.
 //
 // Channel is a first-class Eventarc resource that is created and managed
-// by the subscriber in their GCP project. A Channel represents a subscriber's
-// intent to receive events from an event provider. A Channel is associated with
-// exactly one event provider.
+// by the subscriber in their Google Cloud project. A Channel represents a
+// subscriber's intent to receive events from an event provider. A Channel is
+// associated with exactly one event provider.
 //
 // ChannelConnection is a first-class Eventarc resource that
-// is created and managed by the partner in their GCP project. A
+// is created and managed by the partner in their Google Cloud project. A
 // ChannelConnection represents a connection between a partner and a
 // subscriber's Channel. A ChannelConnection has a one-to-one mapping with a
 // Channel.
 //
+// Bus is a first-class Eventarc resource that is created and managed in a
+// Google Cloud project. A Bus provides a discoverable endpoint for events and
+// is a router that receives all events published by event providers and
+// delivers them to zero or more subscribers.
+//
 // Publisher allows an event provider to publish events to Eventarc.
 service Publisher {
   option (google.api.default_host) = "eventarcpublishing.googleapis.com";
