chore(docs): fix transport README (#2572)

Author: daniel-sanche

gapic/templates/%namespace/%name_%version/%sub/services/%service/transports/README.rst.j2

@@ -2,9 +2,10 @@
 transport inheritance structure
 _______________________________
 
-`{{ service.name }}Transport` is the ABC for all transports.
-- public child `{{ service.name }}GrpcTransport` for sync gRPC transport (defined in `grpc.py`).
-- public child `{{ service.name }}GrpcAsyncIOTransport` for async gRPC transport (defined in `grpc_asyncio.py`).
-- private child `_Base{{ service.name }}RestTransport` for base REST transport with inner classes `_BaseMETHOD` (defined in `rest_base.py`).
-- public child `{{ service.name }}RestTransport` for sync REST transport with inner classes `METHOD` derived from the parent's corresponding `_BaseMETHOD` classes (defined in `rest.py`).
-{# Since the service mixins have a similar structure, we factor out shared code into `_shared_macros.j2` to avoid duplication. #}
+``{{ service.name }}Transport`` is the ABC for all transports.
+
+- public child ``{{ service.name }}GrpcTransport`` for sync gRPC transport (defined in ``grpc.py``).
+- public child ``{{ service.name }}GrpcAsyncIOTransport`` for async gRPC transport (defined in ``grpc_asyncio.py``).
+- private child ``_Base{{ service.name }}RestTransport`` for base REST transport with inner classes ``_BaseMETHOD`` (defined in ``rest_base.py``).
+- public child ``{{ service.name }}RestTransport`` for sync REST transport with inner classes ``METHOD`` derived from the parent's corresponding ``_BaseMETHOD`` classes (defined in ``rest.py``).
+{# Since the service mixins have a similar structure, we factor out shared code into ``_shared_macros.j2`` to avoid duplication. #}

tests/integration/goldens/asset/google/cloud/asset_v1/services/asset_service/transports/README.rst

@@ -2,8 +2,9 @@
 transport inheritance structure
 _______________________________
 
-`AssetServiceTransport` is the ABC for all transports.
-- public child `AssetServiceGrpcTransport` for sync gRPC transport (defined in `grpc.py`).
-- public child `AssetServiceGrpcAsyncIOTransport` for async gRPC transport (defined in `grpc_asyncio.py`).
-- private child `_BaseAssetServiceRestTransport` for base REST transport with inner classes `_BaseMETHOD` (defined in `rest_base.py`).
-- public child `AssetServiceRestTransport` for sync REST transport with inner classes `METHOD` derived from the parent's corresponding `_BaseMETHOD` classes (defined in `rest.py`).
+``AssetServiceTransport`` is the ABC for all transports.
+
+- public child ``AssetServiceGrpcTransport`` for sync gRPC transport (defined in ``grpc.py``).
+- public child ``AssetServiceGrpcAsyncIOTransport`` for async gRPC transport (defined in ``grpc_asyncio.py``).
+- private child ``_BaseAssetServiceRestTransport`` for base REST transport with inner classes ``_BaseMETHOD`` (defined in ``rest_base.py``).
+- public child ``AssetServiceRestTransport`` for sync REST transport with inner classes ``METHOD`` derived from the parent's corresponding ``_BaseMETHOD`` classes (defined in ``rest.py``).

tests/integration/goldens/credentials/google/iam/credentials_v1/services/iam_credentials/transports/README.rst

@@ -2,8 +2,9 @@
 transport inheritance structure
 _______________________________
 
-`IAMCredentialsTransport` is the ABC for all transports.
-- public child `IAMCredentialsGrpcTransport` for sync gRPC transport (defined in `grpc.py`).
-- public child `IAMCredentialsGrpcAsyncIOTransport` for async gRPC transport (defined in `grpc_asyncio.py`).
-- private child `_BaseIAMCredentialsRestTransport` for base REST transport with inner classes `_BaseMETHOD` (defined in `rest_base.py`).
-- public child `IAMCredentialsRestTransport` for sync REST transport with inner classes `METHOD` derived from the parent's corresponding `_BaseMETHOD` classes (defined in `rest.py`).
+``IAMCredentialsTransport`` is the ABC for all transports.
+
+- public child ``IAMCredentialsGrpcTransport`` for sync gRPC transport (defined in ``grpc.py``).
+- public child ``IAMCredentialsGrpcAsyncIOTransport`` for async gRPC transport (defined in ``grpc_asyncio.py``).
+- private child ``_BaseIAMCredentialsRestTransport`` for base REST transport with inner classes ``_BaseMETHOD`` (defined in ``rest_base.py``).
+- public child ``IAMCredentialsRestTransport`` for sync REST transport with inner classes ``METHOD`` derived from the parent's corresponding ``_BaseMETHOD`` classes (defined in ``rest.py``).

tests/integration/goldens/eventarc/google/cloud/eventarc_v1/services/eventarc/transports/README.rst

@@ -2,8 +2,9 @@
 transport inheritance structure
 _______________________________
 
-`EventarcTransport` is the ABC for all transports.
-- public child `EventarcGrpcTransport` for sync gRPC transport (defined in `grpc.py`).
-- public child `EventarcGrpcAsyncIOTransport` for async gRPC transport (defined in `grpc_asyncio.py`).
-- private child `_BaseEventarcRestTransport` for base REST transport with inner classes `_BaseMETHOD` (defined in `rest_base.py`).
-- public child `EventarcRestTransport` for sync REST transport with inner classes `METHOD` derived from the parent's corresponding `_BaseMETHOD` classes (defined in `rest.py`).
+``EventarcTransport`` is the ABC for all transports.
+
+- public child ``EventarcGrpcTransport`` for sync gRPC transport (defined in ``grpc.py``).
+- public child ``EventarcGrpcAsyncIOTransport`` for async gRPC transport (defined in ``grpc_asyncio.py``).
+- private child ``_BaseEventarcRestTransport`` for base REST transport with inner classes ``_BaseMETHOD`` (defined in ``rest_base.py``).
+- public child ``EventarcRestTransport`` for sync REST transport with inner classes ``METHOD`` derived from the parent's corresponding ``_BaseMETHOD`` classes (defined in ``rest.py``).

tests/integration/goldens/logging/google/cloud/logging_v2/services/config_service_v2/transports/README.rst

@@ -2,8 +2,9 @@
 transport inheritance structure
 _______________________________
 
-`ConfigServiceV2Transport` is the ABC for all transports.
-- public child `ConfigServiceV2GrpcTransport` for sync gRPC transport (defined in `grpc.py`).
-- public child `ConfigServiceV2GrpcAsyncIOTransport` for async gRPC transport (defined in `grpc_asyncio.py`).
-- private child `_BaseConfigServiceV2RestTransport` for base REST transport with inner classes `_BaseMETHOD` (defined in `rest_base.py`).
-- public child `ConfigServiceV2RestTransport` for sync REST transport with inner classes `METHOD` derived from the parent's corresponding `_BaseMETHOD` classes (defined in `rest.py`).
+``ConfigServiceV2Transport`` is the ABC for all transports.
+
+- public child ``ConfigServiceV2GrpcTransport`` for sync gRPC transport (defined in ``grpc.py``).
+- public child ``ConfigServiceV2GrpcAsyncIOTransport`` for async gRPC transport (defined in ``grpc_asyncio.py``).
+- private child ``_BaseConfigServiceV2RestTransport`` for base REST transport with inner classes ``_BaseMETHOD`` (defined in ``rest_base.py``).
+- public child ``ConfigServiceV2RestTransport`` for sync REST transport with inner classes ``METHOD`` derived from the parent's corresponding ``_BaseMETHOD`` classes (defined in ``rest.py``).

tests/integration/goldens/logging/google/cloud/logging_v2/services/logging_service_v2/transports/README.rst

@@ -2,8 +2,9 @@
 transport inheritance structure
 _______________________________
 
-`LoggingServiceV2Transport` is the ABC for all transports.
-- public child `LoggingServiceV2GrpcTransport` for sync gRPC transport (defined in `grpc.py`).
-- public child `LoggingServiceV2GrpcAsyncIOTransport` for async gRPC transport (defined in `grpc_asyncio.py`).
-- private child `_BaseLoggingServiceV2RestTransport` for base REST transport with inner classes `_BaseMETHOD` (defined in `rest_base.py`).
-- public child `LoggingServiceV2RestTransport` for sync REST transport with inner classes `METHOD` derived from the parent's corresponding `_BaseMETHOD` classes (defined in `rest.py`).
+``LoggingServiceV2Transport`` is the ABC for all transports.
+
+- public child ``LoggingServiceV2GrpcTransport`` for sync gRPC transport (defined in ``grpc.py``).
+- public child ``LoggingServiceV2GrpcAsyncIOTransport`` for async gRPC transport (defined in ``grpc_asyncio.py``).
+- private child ``_BaseLoggingServiceV2RestTransport`` for base REST transport with inner classes ``_BaseMETHOD`` (defined in ``rest_base.py``).
+- public child ``LoggingServiceV2RestTransport`` for sync REST transport with inner classes ``METHOD`` derived from the parent's corresponding ``_BaseMETHOD`` classes (defined in ``rest.py``).

tests/integration/goldens/logging/google/cloud/logging_v2/services/metrics_service_v2/transports/README.rst

@@ -2,8 +2,9 @@
 transport inheritance structure
 _______________________________
 
-`MetricsServiceV2Transport` is the ABC for all transports.
-- public child `MetricsServiceV2GrpcTransport` for sync gRPC transport (defined in `grpc.py`).
-- public child `MetricsServiceV2GrpcAsyncIOTransport` for async gRPC transport (defined in `grpc_asyncio.py`).
-- private child `_BaseMetricsServiceV2RestTransport` for base REST transport with inner classes `_BaseMETHOD` (defined in `rest_base.py`).
-- public child `MetricsServiceV2RestTransport` for sync REST transport with inner classes `METHOD` derived from the parent's corresponding `_BaseMETHOD` classes (defined in `rest.py`).
+``MetricsServiceV2Transport`` is the ABC for all transports.
+
+- public child ``MetricsServiceV2GrpcTransport`` for sync gRPC transport (defined in ``grpc.py``).
+- public child ``MetricsServiceV2GrpcAsyncIOTransport`` for async gRPC transport (defined in ``grpc_asyncio.py``).
+- private child ``_BaseMetricsServiceV2RestTransport`` for base REST transport with inner classes ``_BaseMETHOD`` (defined in ``rest_base.py``).
+- public child ``MetricsServiceV2RestTransport`` for sync REST transport with inner classes ``METHOD`` derived from the parent's corresponding ``_BaseMETHOD`` classes (defined in ``rest.py``).

tests/integration/goldens/logging_internal/google/cloud/logging_v2/services/config_service_v2/transports/README.rst

@@ -2,8 +2,9 @@
 transport inheritance structure
 _______________________________
 
-`ConfigServiceV2Transport` is the ABC for all transports.
-- public child `ConfigServiceV2GrpcTransport` for sync gRPC transport (defined in `grpc.py`).
-- public child `ConfigServiceV2GrpcAsyncIOTransport` for async gRPC transport (defined in `grpc_asyncio.py`).
-- private child `_BaseConfigServiceV2RestTransport` for base REST transport with inner classes `_BaseMETHOD` (defined in `rest_base.py`).
-- public child `ConfigServiceV2RestTransport` for sync REST transport with inner classes `METHOD` derived from the parent's corresponding `_BaseMETHOD` classes (defined in `rest.py`).
+``ConfigServiceV2Transport`` is the ABC for all transports.
+
+- public child ``ConfigServiceV2GrpcTransport`` for sync gRPC transport (defined in ``grpc.py``).
+- public child ``ConfigServiceV2GrpcAsyncIOTransport`` for async gRPC transport (defined in ``grpc_asyncio.py``).
+- private child ``_BaseConfigServiceV2RestTransport`` for base REST transport with inner classes ``_BaseMETHOD`` (defined in ``rest_base.py``).
+- public child ``ConfigServiceV2RestTransport`` for sync REST transport with inner classes ``METHOD`` derived from the parent's corresponding ``_BaseMETHOD`` classes (defined in ``rest.py``).

tests/integration/goldens/logging_internal/google/cloud/logging_v2/services/logging_service_v2/transports/README.rst

@@ -2,8 +2,9 @@
 transport inheritance structure
 _______________________________
 
-`LoggingServiceV2Transport` is the ABC for all transports.
-- public child `LoggingServiceV2GrpcTransport` for sync gRPC transport (defined in `grpc.py`).
-- public child `LoggingServiceV2GrpcAsyncIOTransport` for async gRPC transport (defined in `grpc_asyncio.py`).
-- private child `_BaseLoggingServiceV2RestTransport` for base REST transport with inner classes `_BaseMETHOD` (defined in `rest_base.py`).
-- public child `LoggingServiceV2RestTransport` for sync REST transport with inner classes `METHOD` derived from the parent's corresponding `_BaseMETHOD` classes (defined in `rest.py`).
+``LoggingServiceV2Transport`` is the ABC for all transports.
+
+- public child ``LoggingServiceV2GrpcTransport`` for sync gRPC transport (defined in ``grpc.py``).
+- public child ``LoggingServiceV2GrpcAsyncIOTransport`` for async gRPC transport (defined in ``grpc_asyncio.py``).
+- private child ``_BaseLoggingServiceV2RestTransport`` for base REST transport with inner classes ``_BaseMETHOD`` (defined in ``rest_base.py``).
+- public child ``LoggingServiceV2RestTransport`` for sync REST transport with inner classes ``METHOD`` derived from the parent's corresponding ``_BaseMETHOD`` classes (defined in ``rest.py``).

tests/integration/goldens/logging_internal/google/cloud/logging_v2/services/metrics_service_v2/transports/README.rst

@@ -2,8 +2,9 @@
 transport inheritance structure
 _______________________________
 
-`MetricsServiceV2Transport` is the ABC for all transports.
-- public child `MetricsServiceV2GrpcTransport` for sync gRPC transport (defined in `grpc.py`).
-- public child `MetricsServiceV2GrpcAsyncIOTransport` for async gRPC transport (defined in `grpc_asyncio.py`).
-- private child `_BaseMetricsServiceV2RestTransport` for base REST transport with inner classes `_BaseMETHOD` (defined in `rest_base.py`).
-- public child `MetricsServiceV2RestTransport` for sync REST transport with inner classes `METHOD` derived from the parent's corresponding `_BaseMETHOD` classes (defined in `rest.py`).
+``MetricsServiceV2Transport`` is the ABC for all transports.
+
+- public child ``MetricsServiceV2GrpcTransport`` for sync gRPC transport (defined in ``grpc.py``).
+- public child ``MetricsServiceV2GrpcAsyncIOTransport`` for async gRPC transport (defined in ``grpc_asyncio.py``).
+- private child ``_BaseMetricsServiceV2RestTransport`` for base REST transport with inner classes ``_BaseMETHOD`` (defined in ``rest_base.py``).
+- public child ``MetricsServiceV2RestTransport`` for sync REST transport with inner classes ``METHOD`` derived from the parent's corresponding ``_BaseMETHOD`` classes (defined in ``rest.py``).