docs: Minor formatting (#369)

* 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: googleapis/googleapis-gen@280264c
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>

packages/google-cloud-tasks/google/cloud/tasks_v2/services/cloud_tasks/async_client.py

@@ -234,6 +234,7 @@ async def list_queues(
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> pagers.ListQueuesAsyncPager:
         r"""Lists queues.
+
         Queues are returned in lexicographical order.
 
         .. code-block:: python
@@ -860,8 +861,10 @@ async def purge_queue(
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> queue.Queue:
         r"""Purges a queue by deleting all of its tasks.
+
         All tasks created before this method is called are
         permanently deleted.
+
         Purge operations can take up to one minute to take
         effect. Tasks might be dispatched before the purge takes
         effect. A purge is irreversible.
@@ -1245,8 +1248,8 @@ async def sample_get_iam_policy():
                 The request object. Request message for ``GetIamPolicy`` method.
             resource (:class:`str`):
                 REQUIRED: The resource for which the
-                policy is being requested.
-                See the operation documentation for the
+                policy is being requested. See the
+                operation documentation for the
                 appropriate value for this field.
 
                 This corresponds to the ``resource`` field
@@ -1401,8 +1404,8 @@ async def sample_set_iam_policy():
                 The request object. Request message for ``SetIamPolicy`` method.
             resource (:class:`str`):
                 REQUIRED: The resource for which the
-                policy is being specified.
-                See the operation documentation for the
+                policy is being specified. See the
+                operation documentation for the
                 appropriate value for this field.
 
                 This corresponds to the ``resource`` field
@@ -1545,8 +1548,8 @@ async def sample_test_iam_permissions():
                 The request object. Request message for ``TestIamPermissions`` method.
             resource (:class:`str`):
                 REQUIRED: The resource for which the
-                policy detail is being requested.
-                See the operation documentation for the
+                policy detail is being requested. See
+                the operation documentation for the
                 appropriate value for this field.
 
                 This corresponds to the ``resource`` field
@@ -2036,6 +2039,7 @@ async def delete_task(
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> None:
         r"""Deletes a task.
+
         A task can be deleted if it is scheduled or dispatched.
         A task cannot be deleted if it has executed successfully
         or permanently failed.

packages/google-cloud-tasks/google/cloud/tasks_v2/services/cloud_tasks/client.py

@@ -489,6 +489,7 @@ def list_queues(
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> pagers.ListQueuesPager:
         r"""Lists queues.
+
         Queues are returned in lexicographical order.
 
         .. code-block:: python
@@ -1085,8 +1086,10 @@ def purge_queue(
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> queue.Queue:
         r"""Purges a queue by deleting all of its tasks.
+
         All tasks created before this method is called are
         permanently deleted.
+
         Purge operations can take up to one minute to take
         effect. Tasks might be dispatched before the purge takes
         effect. A purge is irreversible.
@@ -1470,8 +1473,8 @@ def sample_get_iam_policy():
                 The request object. Request message for ``GetIamPolicy`` method.
             resource (str):
                 REQUIRED: The resource for which the
-                policy is being requested.
-                See the operation documentation for the
+                policy is being requested. See the
+                operation documentation for the
                 appropriate value for this field.
 
                 This corresponds to the ``resource`` field
@@ -1613,8 +1616,8 @@ def sample_set_iam_policy():
                 The request object. Request message for ``SetIamPolicy`` method.
             resource (str):
                 REQUIRED: The resource for which the
-                policy is being specified.
-                See the operation documentation for the
+                policy is being specified. See the
+                operation documentation for the
                 appropriate value for this field.
 
                 This corresponds to the ``resource`` field
@@ -1754,8 +1757,8 @@ def sample_test_iam_permissions():
                 The request object. Request message for ``TestIamPermissions`` method.
             resource (str):
                 REQUIRED: The resource for which the
-                policy detail is being requested.
-                See the operation documentation for the
+                policy detail is being requested. See
+                the operation documentation for the
                 appropriate value for this field.
 
                 This corresponds to the ``resource`` field
@@ -2213,6 +2216,7 @@ def delete_task(
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> None:
         r"""Deletes a task.
+
         A task can be deleted if it is scheduled or dispatched.
         A task cannot be deleted if it has executed successfully
         or permanently failed.

packages/google-cloud-tasks/google/cloud/tasks_v2/services/cloud_tasks/transports/grpc.py

@@ -244,6 +244,7 @@ def list_queues(
         r"""Return a callable for the list queues method over gRPC.
 
         Lists queues.
+
         Queues are returned in lexicographical order.
 
         Returns:
@@ -405,8 +406,10 @@ def purge_queue(self) -> Callable[[cloudtasks.PurgeQueueRequest], queue.Queue]:
         r"""Return a callable for the purge queue method over gRPC.
 
         Purges a queue by deleting all of its tasks.
+
         All tasks created before this method is called are
         permanently deleted.
+
         Purge operations can take up to one minute to take
         effect. Tasks might be dispatched before the purge takes
         effect. A purge is irreversible.
@@ -700,6 +703,7 @@ def delete_task(self) -> Callable[[cloudtasks.DeleteTaskRequest], empty_pb2.Empt
         r"""Return a callable for the delete task method over gRPC.
 
         Deletes a task.
+
         A task can be deleted if it is scheduled or dispatched.
         A task cannot be deleted if it has executed successfully
         or permanently failed.

packages/google-cloud-tasks/google/cloud/tasks_v2/services/cloud_tasks/transports/grpc_asyncio.py

@@ -249,6 +249,7 @@ def list_queues(
         r"""Return a callable for the list queues method over gRPC.
 
         Lists queues.
+
         Queues are returned in lexicographical order.
 
         Returns:
@@ -414,8 +415,10 @@ def purge_queue(
         r"""Return a callable for the purge queue method over gRPC.
 
         Purges a queue by deleting all of its tasks.
+
         All tasks created before this method is called are
         permanently deleted.
+
         Purge operations can take up to one minute to take
         effect. Tasks might be dispatched before the purge takes
         effect. A purge is irreversible.
@@ -719,6 +722,7 @@ def delete_task(
         r"""Return a callable for the delete task method over gRPC.
 
         Deletes a task.
+
         A task can be deleted if it is scheduled or dispatched.
         A task cannot be deleted if it has executed successfully
         or permanently failed.

packages/google-cloud-tasks/google/cloud/tasks_v2/types/queue.py

@@ -320,6 +320,7 @@ class RateLimits(proto.Message):
 
 class RetryConfig(proto.Message):
     r"""Retry config.
+
     These settings determine when a failed task attempt is retried.
 
     Attributes:

packages/google-cloud-tasks/google/cloud/tasks_v2/types/target.py

@@ -305,6 +305,7 @@ class AppEngineHttpRequest(proto.Message):
                app_engine_routing][google.cloud.tasks.v2.AppEngineHttpRequest.app_engine_routing].
         relative_uri (str):
             The relative URI.
+
             The relative URI must begin with "/" and must be
             a valid HTTP relative URI. It can contain a path
             and query string arguments. If the relative URI

packages/google-cloud-tasks/google/cloud/tasks_v2beta2/services/cloud_tasks/async_client.py

@@ -235,6 +235,7 @@ async def list_queues(
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> pagers.ListQueuesAsyncPager:
         r"""Lists queues.
+
         Queues are returned in lexicographical order.
 
         .. code-block:: python
@@ -862,8 +863,10 @@ async def purge_queue(
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> queue.Queue:
         r"""Purges a queue by deleting all of its tasks.
+
         All tasks created before this method is called are
         permanently deleted.
+
         Purge operations can take up to one minute to take
         effect. Tasks might be dispatched before the purge takes
         effect. A purge is irreversible.
@@ -1205,6 +1208,7 @@ async def upload_queue_yaml(
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> None:
         r"""Update queue list by uploading a queue.yaml file.
+
         The queue.yaml file is supplied in the request body as a
         YAML encoded string. This method was added to support
         gcloud clients versions before 322.0.0. New clients
@@ -1313,8 +1317,8 @@ async def sample_get_iam_policy():
                 The request object. Request message for ``GetIamPolicy`` method.
             resource (:class:`str`):
                 REQUIRED: The resource for which the
-                policy is being requested.
-                See the operation documentation for the
+                policy is being requested. See the
+                operation documentation for the
                 appropriate value for this field.
 
                 This corresponds to the ``resource`` field
@@ -1469,8 +1473,8 @@ async def sample_set_iam_policy():
                 The request object. Request message for ``SetIamPolicy`` method.
             resource (:class:`str`):
                 REQUIRED: The resource for which the
-                policy is being specified.
-                See the operation documentation for the
+                policy is being specified. See the
+                operation documentation for the
                 appropriate value for this field.
 
                 This corresponds to the ``resource`` field
@@ -1613,8 +1617,8 @@ async def sample_test_iam_permissions():
                 The request object. Request message for ``TestIamPermissions`` method.
             resource (:class:`str`):
                 REQUIRED: The resource for which the
-                policy detail is being requested.
-                See the operation documentation for the
+                policy detail is being requested. See
+                the operation documentation for the
                 appropriate value for this field.
 
                 This corresponds to the ``resource`` field
@@ -2108,6 +2112,7 @@ async def delete_task(
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> None:
         r"""Deletes a task.
+
         A task can be deleted if it is scheduled or dispatched.
         A task cannot be deleted if it has completed
         successfully or permanently failed.

packages/google-cloud-tasks/google/cloud/tasks_v2beta2/services/cloud_tasks/client.py

@@ -490,6 +490,7 @@ def list_queues(
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> pagers.ListQueuesPager:
         r"""Lists queues.
+
         Queues are returned in lexicographical order.
 
         .. code-block:: python
@@ -1087,8 +1088,10 @@ def purge_queue(
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> queue.Queue:
         r"""Purges a queue by deleting all of its tasks.
+
         All tasks created before this method is called are
         permanently deleted.
+
         Purge operations can take up to one minute to take
         effect. Tasks might be dispatched before the purge takes
         effect. A purge is irreversible.
@@ -1430,6 +1433,7 @@ def upload_queue_yaml(
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> None:
         r"""Update queue list by uploading a queue.yaml file.
+
         The queue.yaml file is supplied in the request body as a
         YAML encoded string. This method was added to support
         gcloud clients versions before 322.0.0. New clients
@@ -1539,8 +1543,8 @@ def sample_get_iam_policy():
                 The request object. Request message for ``GetIamPolicy`` method.
             resource (str):
                 REQUIRED: The resource for which the
-                policy is being requested.
-                See the operation documentation for the
+                policy is being requested. See the
+                operation documentation for the
                 appropriate value for this field.
 
                 This corresponds to the ``resource`` field
@@ -1682,8 +1686,8 @@ def sample_set_iam_policy():
                 The request object. Request message for ``SetIamPolicy`` method.
             resource (str):
                 REQUIRED: The resource for which the
-                policy is being specified.
-                See the operation documentation for the
+                policy is being specified. See the
+                operation documentation for the
                 appropriate value for this field.
 
                 This corresponds to the ``resource`` field
@@ -1823,8 +1827,8 @@ def sample_test_iam_permissions():
                 The request object. Request message for ``TestIamPermissions`` method.
             resource (str):
                 REQUIRED: The resource for which the
-                policy detail is being requested.
-                See the operation documentation for the
+                policy detail is being requested. See
+                the operation documentation for the
                 appropriate value for this field.
 
                 This corresponds to the ``resource`` field
@@ -2286,6 +2290,7 @@ def delete_task(
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> None:
         r"""Deletes a task.
+
         A task can be deleted if it is scheduled or dispatched.
         A task cannot be deleted if it has completed
         successfully or permanently failed.

packages/google-cloud-tasks/google/cloud/tasks_v2beta2/services/cloud_tasks/transports/grpc.py

@@ -244,6 +244,7 @@ def list_queues(
         r"""Return a callable for the list queues method over gRPC.
 
         Lists queues.
+
         Queues are returned in lexicographical order.
 
         Returns:
@@ -405,8 +406,10 @@ def purge_queue(self) -> Callable[[cloudtasks.PurgeQueueRequest], queue.Queue]:
         r"""Return a callable for the purge queue method over gRPC.
 
         Purges a queue by deleting all of its tasks.
+
         All tasks created before this method is called are
         permanently deleted.
+
         Purge operations can take up to one minute to take
         effect. Tasks might be dispatched before the purge takes
         effect. A purge is irreversible.
@@ -505,6 +508,7 @@ def upload_queue_yaml(
         r"""Return a callable for the upload queue yaml method over gRPC.
 
         Update queue list by uploading a queue.yaml file.
+
         The queue.yaml file is supplied in the request body as a
         YAML encoded string. This method was added to support
         gcloud clients versions before 322.0.0. New clients
@@ -734,6 +738,7 @@ def delete_task(self) -> Callable[[cloudtasks.DeleteTaskRequest], empty_pb2.Empt
         r"""Return a callable for the delete task method over gRPC.
 
         Deletes a task.
+
         A task can be deleted if it is scheduled or dispatched.
         A task cannot be deleted if it has completed
         successfully or permanently failed.

packages/google-cloud-tasks/google/cloud/tasks_v2beta2/services/cloud_tasks/transports/grpc_asyncio.py

@@ -249,6 +249,7 @@ def list_queues(
         r"""Return a callable for the list queues method over gRPC.
 
         Lists queues.
+
         Queues are returned in lexicographical order.
 
         Returns:
@@ -414,8 +415,10 @@ def purge_queue(
         r"""Return a callable for the purge queue method over gRPC.
 
         Purges a queue by deleting all of its tasks.
+
         All tasks created before this method is called are
         permanently deleted.
+
         Purge operations can take up to one minute to take
         effect. Tasks might be dispatched before the purge takes
         effect. A purge is irreversible.
@@ -518,6 +521,7 @@ def upload_queue_yaml(
         r"""Return a callable for the upload queue yaml method over gRPC.
 
         Update queue list by uploading a queue.yaml file.
+
         The queue.yaml file is supplied in the request body as a
         YAML encoded string. This method was added to support
         gcloud clients versions before 322.0.0. New clients
@@ -753,6 +757,7 @@ def delete_task(
         r"""Return a callable for the delete task method over gRPC.
 
         Deletes a task.
+
         A task can be deleted if it is scheduled or dispatched.
         A task cannot be deleted if it has completed
         successfully or permanently failed.