docs: Minor formatting (#195)

* docs: Minor formatting
chore: Update gapic-generator-python to v1.11.5
build: Update rules_python to 0.24.0

PiperOrigin-RevId: 563436317

Source-Link: googleapis/googleapis@42fd37b

Source-Link: https://github.com/googleapis/googleapis-gen/commit/280264ca02fb9316b4237a96d0af1a2343a81a56
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMjgwMjY0Y2EwMmZiOTMxNmI0MjM3YTk2ZDBhZjFhMjM0M2E4MWE1NiJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

google/cloud/dataflow_v1beta3/types/environment.py

@@ -56,12 +56,12 @@ class JobType(proto.Enum):
             unknown.
         JOB_TYPE_BATCH (1):
             A batch job with a well-defined end point:
-            data is read, data is
-            processed, data is written, and the job is done.
+            data is read, data is processed, data is
+            written, and the job is done.
         JOB_TYPE_STREAMING (2):
             A continuously streaming job with no end:
-            data is read,
-            processed, and written continuously.
+            data is read, processed, and written
+            continuously.
     """
     JOB_TYPE_UNKNOWN = 0
     JOB_TYPE_BATCH = 1
@@ -385,7 +385,6 @@ class Package(proto.Message):
         location (str):
             The resource to read the package from. The
             supported resource type is:
-
             Google Cloud Storage:
 
               storage.googleapis.com/{bucket}
@@ -428,6 +427,7 @@ class Disk(proto.Message):
             documentation for more information about
             determining the set of available disk types for
             a particular project and zone.
+
             Google Compute Engine Disk types are local to a
             particular project in a particular zone, and so
             the resource name will typically look something
@@ -458,6 +458,7 @@ class WorkerSettings(proto.Message):
     Attributes:
         base_url (str):
             The base URL for accessing Google Cloud APIs.
+
             When workers access Google Cloud APIs, they
             logically do so via relative URLs.  If this
             field is specified, it supplies the base URL to

google/cloud/dataflow_v1beta3/types/jobs.py

@@ -223,6 +223,7 @@ class Job(proto.Message):
     Attributes:
         id (str):
             The unique ID of this job.
+
             This field is set by the Cloud Dataflow service
             when the Job is created, and is immutable for
             the life of the job.

google/cloud/dataflow_v1beta3/types/messages.py

@@ -43,43 +43,39 @@ class JobMessageImportance(proto.Enum):
             unknown.
         JOB_MESSAGE_DEBUG (1):
             The message is at the 'debug' level:
-            typically only useful for
-            software engineers working on the code the job
-            is running. Typically, Dataflow pipeline runners
-            do not display log messages at this level by
-            default.
+            typically only useful for software engineers
+            working on the code the job is running.
+            Typically, Dataflow pipeline runners do not
+            display log messages at this level by default.
         JOB_MESSAGE_DETAILED (2):
             The message is at the 'detailed' level:
-            somewhat verbose, but
-            potentially useful to users.  Typically,
-            Dataflow pipeline runners do not display log
-            messages at this level by default. These
-            messages are displayed by default in the
-            Dataflow monitoring UI.
+            somewhat verbose, but potentially useful to
+            users.  Typically, Dataflow pipeline runners do
+            not display log messages at this level by
+            default. These messages are displayed by default
+            in the Dataflow monitoring UI.
         JOB_MESSAGE_BASIC (5):
             The message is at the 'basic' level: useful
-            for keeping
-            track of the execution of a Dataflow pipeline.
-            Typically, Dataflow pipeline runners display log
-            messages at this level by default, and these
-            messages are displayed by default in the
-            Dataflow monitoring UI.
+            for keeping track of the execution of a Dataflow
+            pipeline.  Typically, Dataflow pipeline runners
+            display log messages at this level by default,
+            and these messages are displayed by default in
+            the Dataflow monitoring UI.
         JOB_MESSAGE_WARNING (3):
             The message is at the 'warning' level:
-            indicating a condition
-            pertaining to a job which may require human
-            intervention. Typically, Dataflow pipeline
-            runners display log messages at this level by
-            default, and these messages are displayed by
-            default in the Dataflow monitoring UI.
-        JOB_MESSAGE_ERROR (4):
-            The message is at the 'error' level:
-            indicating a condition
-            preventing a job from succeeding.  Typically,
+            indicating a condition pertaining to a job which
+            may require human intervention. Typically,
             Dataflow pipeline runners display log messages
             at this level by default, and these messages are
             displayed by default in the Dataflow monitoring
             UI.
+        JOB_MESSAGE_ERROR (4):
+            The message is at the 'error' level:
+            indicating a condition preventing a job from
+            succeeding.  Typically, Dataflow pipeline
+            runners display log messages at this level by
+            default, and these messages are displayed by
+            default in the Dataflow monitoring UI.
     """
     JOB_MESSAGE_IMPORTANCE_UNKNOWN = 0
     JOB_MESSAGE_DEBUG = 1

google/cloud/dataflow_v1beta3/types/metrics.py

@@ -116,6 +116,7 @@ class MetricUpdate(proto.Message):
             "Mean", "Set", "And", "Or", and "Distribution".
             The specified aggregation kind is
             case-insensitive.
+
             If omitted, this is not an aggregated value but
             instead a single metric sample value.
         cumulative (bool):
@@ -342,6 +343,7 @@ class ProgressTimeseries(proto.Message):
             The current progress of the component, in the range [0,1].
         data_points (MutableSequence[google.cloud.dataflow_v1beta3.types.ProgressTimeseries.Point]):
             History of progress for the component.
+
             Points are sorted by time.
     """
 
@@ -388,6 +390,7 @@ class StageSummary(proto.Message):
             Start time of this stage.
         end_time (google.protobuf.timestamp_pb2.Timestamp):
             End time of this stage.
+
             If the work item is completed, this is the
             actual end time of the stage. Otherwise, it is
             the predicted end time.
@@ -537,6 +540,7 @@ class WorkItemDetails(proto.Message):
             Start time of this work item attempt.
         end_time (google.protobuf.timestamp_pb2.Timestamp):
             End time of this work item attempt.
+
             If the work item is completed, this is the
             actual end time of the work item.  Otherwise, it
             is the predicted end time.