docs: Minor formatting (#520)

* 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>

Author: gcf-owl-bot[bot]

google/cloud/dlp_v2/services/dlp_service/async_client.py

@@ -63,6 +63,7 @@ class DlpServiceAsyncClient:
     The service also includes methods for sensitive data redaction
     and scheduling of data scans on Google Cloud Platform based data
     sets.
+
     To learn more about concepts and find how-to guides see
     https://cloud.google.com/dlp/docs/.
     """
@@ -251,10 +252,12 @@ async def inspect_content(
         r"""Finds potentially sensitive info in content.
         This method has limits on input size, processing time,
         and output size.
+
         When no InfoTypes or CustomInfoTypes are specified in
         this request, the system will automatically choose what
         detectors to run. By default this may be all types, but
         may change over time as detectors are updated.
+
         For how to guides, see
         https://cloud.google.com/dlp/docs/inspecting-images and
         https://cloud.google.com/dlp/docs/inspecting-text,
@@ -2582,6 +2585,7 @@ async def sample_list_job_triggers():
         Returns:
             google.cloud.dlp_v2.services.dlp_service.pagers.ListJobTriggersAsyncPager:
                 Response message for ListJobTriggers.
+
                 Iterating over this object will yield
                 results and resolve additional pages
                 automatically.
@@ -2849,6 +2853,7 @@ async def create_dlp_job(
         https://cloud.google.com/dlp/docs/inspecting-storage and
         https://cloud.google.com/dlp/docs/compute-risk-analysis
         to learn more.
+
         When no InfoTypes or CustomInfoTypes are specified in
         inspect jobs, the system will automatically choose what
         detectors to run. By default this may be all types, but

google/cloud/dlp_v2/services/dlp_service/client.py

@@ -103,6 +103,7 @@ class DlpServiceClient(metaclass=DlpServiceClientMeta):
     The service also includes methods for sensitive data redaction
     and scheduling of data scans on Google Cloud Platform based data
     sets.
+
     To learn more about concepts and find how-to guides see
     https://cloud.google.com/dlp/docs/.
     """
@@ -579,10 +580,12 @@ def inspect_content(
         r"""Finds potentially sensitive info in content.
         This method has limits on input size, processing time,
         and output size.
+
         When no InfoTypes or CustomInfoTypes are specified in
         this request, the system will automatically choose what
         detectors to run. By default this may be all types, but
         may change over time as detectors are updated.
+
         For how to guides, see
         https://cloud.google.com/dlp/docs/inspecting-images and
         https://cloud.google.com/dlp/docs/inspecting-text,
@@ -2804,6 +2807,7 @@ def sample_list_job_triggers():
         Returns:
             google.cloud.dlp_v2.services.dlp_service.pagers.ListJobTriggersPager:
                 Response message for ListJobTriggers.
+
                 Iterating over this object will yield
                 results and resolve additional pages
                 automatically.
@@ -3052,6 +3056,7 @@ def create_dlp_job(
         https://cloud.google.com/dlp/docs/inspecting-storage and
         https://cloud.google.com/dlp/docs/compute-risk-analysis
         to learn more.
+
         When no InfoTypes or CustomInfoTypes are specified in
         inspect jobs, the system will automatically choose what
         detectors to run. By default this may be all types, but

google/cloud/dlp_v2/services/dlp_service/transports/grpc.py

@@ -40,6 +40,7 @@ class DlpServiceGrpcTransport(DlpServiceTransport):
     The service also includes methods for sensitive data redaction
     and scheduling of data scans on Google Cloud Platform based data
     sets.
+
     To learn more about concepts and find how-to guides see
     https://cloud.google.com/dlp/docs/.
 
@@ -248,10 +249,12 @@ def inspect_content(
         Finds potentially sensitive info in content.
         This method has limits on input size, processing time,
         and output size.
+
         When no InfoTypes or CustomInfoTypes are specified in
         this request, the system will automatically choose what
         detectors to run. By default this may be all types, but
         may change over time as detectors are updated.
+
         For how to guides, see
         https://cloud.google.com/dlp/docs/inspecting-images and
         https://cloud.google.com/dlp/docs/inspecting-text,
@@ -901,6 +904,7 @@ def create_dlp_job(self) -> Callable[[dlp.CreateDlpJobRequest], dlp.DlpJob]:
         https://cloud.google.com/dlp/docs/inspecting-storage and
         https://cloud.google.com/dlp/docs/compute-risk-analysis
         to learn more.
+
         When no InfoTypes or CustomInfoTypes are specified in
         inspect jobs, the system will automatically choose what
         detectors to run. By default this may be all types, but

google/cloud/dlp_v2/services/dlp_service/transports/grpc_asyncio.py

@@ -41,6 +41,7 @@ class DlpServiceGrpcAsyncIOTransport(DlpServiceTransport):
     The service also includes methods for sensitive data redaction
     and scheduling of data scans on Google Cloud Platform based data
     sets.
+
     To learn more about concepts and find how-to guides see
     https://cloud.google.com/dlp/docs/.
 
@@ -251,10 +252,12 @@ def inspect_content(
         Finds potentially sensitive info in content.
         This method has limits on input size, processing time,
         and output size.
+
         When no InfoTypes or CustomInfoTypes are specified in
         this request, the system will automatically choose what
         detectors to run. By default this may be all types, but
         may change over time as detectors are updated.
+
         For how to guides, see
         https://cloud.google.com/dlp/docs/inspecting-images and
         https://cloud.google.com/dlp/docs/inspecting-text,
@@ -923,6 +926,7 @@ def create_dlp_job(
         https://cloud.google.com/dlp/docs/inspecting-storage and
         https://cloud.google.com/dlp/docs/compute-risk-analysis
         to learn more.
+
         When no InfoTypes or CustomInfoTypes are specified in
         inspect jobs, the system will automatically choose what
         detectors to run. By default this may be all types, but

google/cloud/dlp_v2/services/dlp_service/transports/rest.py

@@ -994,6 +994,7 @@ class DlpServiceRestTransport(DlpServiceTransport):
     The service also includes methods for sensitive data redaction
     and scheduling of data scans on Google Cloud Platform based data
     sets.
+
     To learn more about concepts and find how-to guides see
     https://cloud.google.com/dlp/docs/.
 

google/cloud/dlp_v2/types/dlp.py

@@ -345,6 +345,7 @@ class MatchingType(proto.Enum):
             Invalid.
         MATCHING_TYPE_FULL_MATCH (1):
             Full match.
+
             - Dictionary: join of Dictionary results matched
               complete finding quote
             - Regex: all regex matches fill a finding quote
@@ -353,13 +354,15 @@ class MatchingType(proto.Enum):
               info types findings
         MATCHING_TYPE_PARTIAL_MATCH (2):
             Partial match.
+
             - Dictionary: at least one of the tokens in the
               finding matches
             - Regex: substring of the finding matches
             - Exclude info type: intersects with affecting
               info types findings
         MATCHING_TYPE_INVERSE_MATCH (3):
             Inverse match.
+
             - Dictionary: no tokens in the finding match the
               dictionary
             - Regex: finding doesn't match the regex
@@ -5035,6 +5038,7 @@ class DateShiftConfig(proto.Message):
             range (inclusive ends). Negative means shift to
             earlier in time. Must not be more than 365250
             days (1000 years) each direction.
+
             For example, 3 means shift date to at most 3
             days into the future.
         lower_bound_days (int):
@@ -5737,9 +5741,11 @@ class Schedule(proto.Message):
             With this option a job is started on a
             regular periodic basis. For example: every day
             (86400 seconds).
+
             A scheduled start time will be skipped if the
             previous execution has not ended when its
             scheduled time occurs.
+
             This value must be set to a time duration
             greater than or equal to 1 day and can be no
             longer than 60 days.
@@ -6224,6 +6230,7 @@ class Deidentify(proto.Message):
                 bucket must be different from the input bucket.
                 De-identified files will overwrite files in the
                 output path.
+
                 Form of: gs://bucket/folder/ or gs://bucket
 
                 This field is a member of `oneof`_ ``output``.

google/cloud/dlp_v2/types/storage.py

@@ -633,6 +633,7 @@ class PartitionId(proto.Message):
     A partition ID identifies a grouping of entities. The grouping
     is always by project and namespace, however the namespace ID may
     be empty.
+
     A partition ID contains several dimensions:
 
     project ID and namespace ID.
@@ -1290,6 +1291,7 @@ class Key(proto.Message):
 
     class PathElement(proto.Message):
         r"""A (kind, ID/name) pair used to construct a key path.
+
         If either name or ID is set, the element is complete. If neither
         is set, the element is incomplete.