From 1e9a70ea637028d9195ec561319ef104769dc9ad Mon Sep 17 00:00:00 2001 From: Anthonios Partheniou Date: Mon, 13 Apr 2026 14:36:53 -0400 Subject: [PATCH] chore: remove post processing for docs Fixes https://github.com/googleapis/google-cloud-python/issues/16629 --- .../doc-formatting.yaml | 576 ------------------ 1 file changed, 576 deletions(-) delete mode 100644 .librarian/generator-input/client-post-processing/doc-formatting.yaml diff --git a/.librarian/generator-input/client-post-processing/doc-formatting.yaml b/.librarian/generator-input/client-post-processing/doc-formatting.yaml deleted file mode 100644 index 6c654c8f81cc..000000000000 --- a/.librarian/generator-input/client-post-processing/doc-formatting.yaml +++ /dev/null @@ -1,576 +0,0 @@ -# Copyright 2023 Google LLC -# -# Licensed under the Apache License, Version 2.0 (the "License"); -# you may not use this file except in compliance with the License. -# You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, software -# distributed under the License is distributed on an "AS IS" BASIS, -# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -# See the License for the specific language governing permissions and -# limitations under the License. -description: Fix formatting issues in docs -url: https://github.com/googleapis/gapic-generator-python/issues/1829 -replacements: - - paths: [ - packages/google-ai-generativelanguage/google/ai/generativelanguage_v1beta3/services/permission_service/async_client.py, - packages/google-ai-generativelanguage/google/ai/generativelanguage_v1beta3/services/permission_service/client.py - ] - before: | - \ role's permitted operations: - \ - \ - reader can use the resource \(e.g. - \ tuned model\) for inference - \ - writer has reader's permissions and - \ additionally can edit and share - \ - owner has writer's permissions and - \ additionally can delete - after: " role's permitted operations:\n\n - reader can use the resource (e.g.\n tuned model) for inference\n - writer has reader's permissions and\n additionally can edit and share\n - owner has writer's permissions and\n additionally can delete\n" - count: 6 - - paths: [ - packages/google-ai-generativelanguage/google/ai/generativelanguage_v1beta3/types/permission.py, - ] - before: | - \ previous role's permitted operations: - \ - \ - reader can use the resource \(e.g. tuned model\) for inference - \ - writer has reader's permissions and additionally can edit and - \ share - \ - owner has writer's permissions and additionally can delete - after: " previous role's permitted operations:\n\n - reader can use the resource (e.g. tuned model) for inference\n - writer has reader's permissions and additionally can edit and\n share\n - owner has writer's permissions and additionally can delete\n" - count: 1 - - paths: [ - packages/google-cloud-datacatalog/google/cloud/datacatalog_v1beta1/types/usage.py, - ] - before: | - \ references are not yet counted in usage computation - \ https://cloud.google.com/bigquery/docs/querying-wildcard-tables - after: " references are not yet counted in usage computation\n https://cloud.google.com/bigquery/docs/querying-wildcard-tables\n" - count: 1 - - paths: [ - packages/google-cloud-edgenetwork/google/cloud/edgenetwork_v1/types/resources.py, - ] - before: | - \ 14 years, 51 weeks, 6 days, 23 hours, 59 - after: " 14 years, 51 weeks, 6 days, 23 hours, 59\n" - count: 1 - - paths: [ - packages/google-cloud-network-connectivity/google/cloud/networkconnectivity_v1/types/policy_based_routing.py, - ] - before: | - \ 1000. The priority value must be from 1 to - \ 65535, inclusive. - after: " 1000. The priority value must be from 1 to\n 65535, inclusive.\n" - count: 1 - - paths: [ - packages/google-cloud-visionai/google/cloud/visionai_v1/types/platform.py, - packages/google-cloud-visionai/google/cloud/visionai_v1alpha1/types/platform.py, - ] - before: | - \ 'ingestionTime': DOUBLE; \(UNIX timestamp\) - \ 'application': STRING; - after: " 'ingestionTime': DOUBLE; (UNIX timestamp)\n 'application': STRING;\n" - count: 2 - - paths: [ - packages/google-cloud-visionai/google/cloud/visionai_v1/types/platform.py, - packages/google-cloud-visionai/google/cloud/visionai_v1alpha1/types/platform.py, - ] - before: "'processor': STRING;\n }\n" - after: "'processor': STRING;\n\n }\n\n" - count: 2 - - paths: [ - packages/google-cloud-documentai/google/cloud/documentai_v1beta3/types/document_service.py, - ] - before: | - \n Currently support query strings are: - \ ------------------------------------ - \ - \ ``SplitType=DATASET_SPLIT_TEST\|DATASET_SPLIT_TRAIN\|DATASET_SPLIT_UNASSIGNED`` - \ - \ - ``LabelingState=DOCUMENT_LABELED\|DOCUMENT_UNLABELED\|DOCUMENT_AUTO_LABELED`` - after: "\n Currently support query strings are:\n\n - ``SplitType=DATASET_SPLIT_TEST|DATASET_SPLIT_TRAIN|DATASET_SPLIT_UNASSIGNED``\n - ``LabelingState=DOCUMENT_LABELED|DOCUMENT_UNLABELED|DOCUMENT_AUTO_LABELED``\n" - count: 1 - - paths: [ - packages/google-apps-chat/google/apps/chat_v1/services/chat_service/async_client.py, - ] - before: \|Message sent with app authentication\| - after: "|Message sent with app authentication async|" - count: 2 - - paths: [ - packages/google-apps-chat/google/apps/chat_v1/services/chat_service/transports/grpc_asyncio.py, - ] - before: \|Message sent with app authentication\| - after: "|Message sent with app authentication async gRPC|" - count: 2 - - paths: [ - packages/google-apps-chat/google/apps/chat_v1/services/chat_service/transports/grpc.py, - ] - before: \|Message sent with app authentication\| - after: "|Message sent with app authentication gRPC|" - count: 2 - - paths: [ - packages/google-apps-chat/google/apps/chat_v1/services/chat_service/async_client.py, - ] - before: \|Message sent with user authentication\| - after: "|Message sent with user authentication async|" - count: 2 - - paths: [ - packages/google-apps-chat/google/apps/chat_v1/services/chat_service/transports/grpc_asyncio.py, - ] - before: \|Message sent with user authentication\| - after: "|Message sent with user authentication async gRPC|" - count: 2 - - paths: [ - packages/google-apps-chat/google/apps/chat_v1/services/chat_service/transports/grpc.py, - ] - before: \|Message sent with user authentication\| - after: "|Message sent with user authentication gRPC|" - count: 2 - - paths: [ - packages/google-cloud-alloydb/google/cloud/alloydb_v1/types/resources.py, - packages/google-cloud-alloydb/google/cloud/alloydb_v1alpha/types/resources.py, - packages/google-cloud-alloydb/google/cloud/alloydb_v1beta/types/resources.py, - ] - before: | - \ 1024. Any integer between 256 and 4500 is - \ considered valid. - after: " 1024. Any integer between 256 and 4500 is\n considered valid.\n" - count: 3 - - paths: [ - packages/google-cloud-dms/google/cloud/clouddms_v1/types/conversionworkspace_resources.py, - ] - before: | - Optional. Column fractional seconds precision - \ - used only for timestamp based datatypes - if - \ not specified and relevant uses the source - after: | - Optional. Column fractional seconds precision: - - - used only for timestamp based datatypes - - if not specified and relevant uses the source - count: 1 - - paths: [ - packages/google-cloud-enterpriseknowledgegraph/google/cloud/enterpriseknowledgegraph_v1/types/service.py, - ] - before: | - If true, separate clusters by their - \ geographic region \(from geocoding\). Uses the - \ following entity features:\n - \ - schema.org/addressLocality - \ - schema.org/addressRegion - \ - schema.org/addressCountry - \ Warning: processing will no longer be - \ regionalized! - after: | - If true, separate clusters by their - geographic region (from geocoding). Uses the - following entity features:\n - - schema.org/addressLocality - - schema.org/addressRegion - - schema.org/addressCountry\n - Warning: processing will no longer be - regionalized! - count: 1 - - paths: [ - packages/google-cloud-gdchardwaremanagement/google/cloud/gdchardwaremanagement_v1alpha/types/resources.py, - ] - before: | - Optional. Any additional notes for this Site. - \ Please include information about:\n - \ - security or access restrictions - \ - any regulations affecting the technicians - \ visiting the site - \ - any special process or approval required to - \ move the equipment - \ - whether a representative will be available - \ during site visits - after: | - Optional. Any additional notes for this Site. - Please include information about:\n - - security or access restrictions - - any regulations affecting the technicians - visiting the site - - any special process or approval required to - move the equipment - - whether a representative will be available - during site visits\n - count: 1 - - paths: [ - packages/google-cloud-oracledatabase/google/cloud/oracledatabase_v1/types/exadata_infra.py, - ] - before: | - Optional. The window of hours during the day - \ when maintenance should be performed. The window - \ is a 4 hour slot. Valid values are:\n - \ 0 - represents time slot 0:00 - 3:59 UTC - \ 4 - represents time slot 4:00 - 7:59 UTC - \ 8 - represents time slot 8:00 - 11:59 UTC - \ 12 - represents time slot 12:00 - 15:59 UTC - \ 16 - represents time slot 16:00 - 19:59 UTC 20 - \ - represents time slot 20:00 - 23:59 UTC - after: | - Optional. The window of hours during the day - when maintenance should be performed. The window - is a 4 hour slot. Valid values are:\n - 0 - represents time slot 0:00 - 3:59 UTC - 4 - represents time slot 4:00 - 7:59 UTC - 8 - represents time slot 8:00 - 11:59 UTC - 12 - represents time slot 12:00 - 15:59 UTC - 16 - represents time slot 16:00 - 19:59 UTC - 20 - represents time slot 20:00 - 23:59 UTC - count: 1 - - paths: [ - packages/google-cloud-service-control/google/cloud/servicecontrol_v1/types/service_controller.py, - ] - before: | - The Google cloud project number, e.g. - \ 1234567890. A value of 0 indicates no project - \ number is found. - after: | - The Google cloud project number, e.g. - 1234567890. A value of 0 indicates no project - number is found. - count: 1 - - paths: [ - packages/google-maps-routing/google/maps/routing_v2/types/toll_passes.py, - ] - before: | - E-card provided by multiple banks used to pay - \ for tolls. All e-cards via banks are charged the - \ same so only one enum value is needed. E.g. - \ - Bank Mandiri - after: | - E-card provided by multiple banks used to pay - for tolls. All e-cards via banks are charged the - same so only one enum value is needed. E.g.\n - - Bank Mandiri - count: 1 - - paths: [ - packages/google-shopping-merchant-accounts/google/shopping/merchant_accounts_v1beta/services/online_return_policy_service/async_client.py, - packages/google-shopping-merchant-accounts/google/shopping/merchant_accounts_v1beta/services/online_return_policy_service/client.py, - packages/google-shopping-merchant-accounts/google/shopping/merchant_accounts_v1beta/services/online_return_policy_service/transports/grpc.py, - packages/google-shopping-merchant-accounts/google/shopping/merchant_accounts_v1beta/services/online_return_policy_service/transports/grpc_asyncio.py, - ] - before: "This API defines the following resource model:\n --------------------------------------------------------\n\n `OnlineReturnPolicy" - after: "This API defines the following resource model:\n\n - `OnlineReturnPolicy" - count: 4 - - paths: [ - packages/google-shopping-merchant-accounts/google/shopping/merchant_accounts_v1/services/online_return_policy_service/async_client.py, - packages/google-shopping-merchant-accounts/google/shopping/merchant_accounts_v1/services/online_return_policy_service/client.py, - packages/google-shopping-merchant-accounts/google/shopping/merchant_accounts_v1/services/online_return_policy_service/transports/grpc.py, - packages/google-shopping-merchant-accounts/google/shopping/merchant_accounts_v1/services/online_return_policy_service/transports/grpc_asyncio.py, - ] - before: "This API defines the following resource model:\n --------------------------------------------------------\n\n \\[OnlineReturnPolicy" - after: "This API defines the following resource model:\n\n - [OnlineReturnPolicy" - count: 4 - - paths: [ - packages/google-shopping-merchant-accounts/google/shopping/merchant_accounts_v1beta/services/omnichannel_settings_service/async_client.py, - packages/google-shopping-merchant-accounts/google/shopping/merchant_accounts_v1beta/services/omnichannel_settings_service/client.py, - packages/google-shopping-merchant-accounts/google/shopping/merchant_accounts_v1beta/services/omnichannel_settings_service/transports/grpc.py, - packages/google-shopping-merchant-accounts/google/shopping/merchant_accounts_v1beta/services/omnichannel_settings_service/transports/grpc_asyncio.py, - packages/google-shopping-merchant-accounts/google/shopping/merchant_accounts_v1/services/omnichannel_settings_service/async_client.py, - packages/google-shopping-merchant-accounts/google/shopping/merchant_accounts_v1/services/omnichannel_settings_service/client.py, - packages/google-shopping-merchant-accounts/google/shopping/merchant_accounts_v1/services/omnichannel_settings_service/transports/grpc.py, - packages/google-shopping-merchant-accounts/google/shopping/merchant_accounts_v1/services/omnichannel_settings_service/transports/grpc_asyncio.py, - ] - before: | - This API defines the following resource model: - \ ----------------------------------------------\n - \ \[OmnichannelSetting\]\[google.shopping.merchant.accounts.v1.OmnichannelSetting\] - after: | - This API defines the following resource model: - - [OmnichannelSetting][google.shopping.merchant.accounts.v1.OmnichannelSetting] - count: 8 - - paths: [ - packages/google-shopping-merchant-accounts/google/shopping/merchant_accounts_v1beta/types/shippingsettings.py - ] - before: | - Required. This field is used for avoid async - \ issue. Make sure shipping setting data - \ didn't change between get call and insert call. - after: | - Required. This field is used for avoid async - issue. Make sure shipping setting data - didn't change between get call and insert call. - count: 1 - - paths: [ - packages/google-shopping-merchant-reports/google/shopping/merchant_reports_v1alpha/types/reports.py, - packages/google-shopping-merchant-reports/google/shopping/merchant_reports_v1beta/types/reports.py, - packages/google-shopping-merchant-reports/google/shopping/merchant_reports_v1/types/reports.py, - ] - before: | - Here's an example of how the aggregated status is computed:\n - \ Free listings \\\| Shopping ads \\\| Status - \ --------------\\\|--------------\\\|------------------------------ - \ Approved \\\| Approved \\\| ELIGIBLE Approved \\\| Pending \\\| ELIGIBLE - \ Approved \\\| Disapproved \\\| ELIGIBLE_LIMITED Pending \\\| Pending \\\| - \ PENDING Disapproved \\\| Disapproved \\\| NOT_ELIGIBLE_OR_DISAPPROVED\n - \ Values: - after: | - Here's an example of how the aggregated status is computed:\n - ``` - Free listings \| Shopping ads \| Status - --------------\|--------------\|------------------------------ - Approved \| Approved \| ELIGIBLE Approved \| Pending \| ELIGIBLE - Approved \| Disapproved \| ELIGIBLE_LIMITED Pending \| Pending \| - PENDING Disapproved \| Disapproved \| NOT_ELIGIBLE_OR_DISAPPROVED - ```\n - Values: - count: 3 - - paths: [ - packages/google-cloud-monitoring/google/cloud/monitoring_v3/types/metric_service.py - ] - before: | - Optional. If true, only metrics and monitored - \ resource types that have recent data \(within - \ roughly 25 hours\) will be included in the - \ response. - \ - If a metric descriptor enumerates monitored - \ resource types, only the monitored resource - \ types for which the metric type has recent - \ data will be included in the returned - \ metric descriptor, and if none of them have - \ recent data, the metric descriptor will not be - \ returned. - \ - If a metric descriptor does not enumerate the - \ compatible monitored resource types, it - \ will be returned only if the metric type has - \ recent data for some monitored resource - \ type. The returned descriptor will not - \ enumerate any monitored resource types. - after: | - Optional. If true, only metrics and monitored - resource types that have recent data (within - roughly 25 hours) will be included in the - response.\n - - If a metric descriptor enumerates monitored - resource types, only the monitored resource - types for which the metric type has recent - data will be included in the returned - metric descriptor, and if none of them have - recent data, the metric descriptor will not be - returned. - - If a metric descriptor does not enumerate the - compatible monitored resource types, it - will be returned only if the metric type has - recent data for some monitored resource - type. The returned descriptor will not - enumerate any monitored resource types. - count: 1 - - paths: [ - packages/google-cloud-orchestration-airflow/google/cloud/orchestration/airflow/service_v1/types/environments.py, - packages/google-cloud-orchestration-airflow/google/cloud/orchestration/airflow/service_v1beta1/types/environments.py, - ] - before: | - \{ - "example": "ZXhhbXBsZV92YWx1ZQ==", - "another-example": - "YW5vdGhlcl9leGFtcGxlX3ZhbHVl" \} - after: | - .. code-block:: json\n - { - "example": "ZXhhbXBsZV92YWx1ZQ==", - "another-example": "YW5vdGhlcl9leGFtcGxlX3ZhbHVl" - }\n - count: 2 - - paths: [ - packages/google-cloud-automl/google/cloud/automl_v1/types/io.py, - ] - before: "Classification\n ''''''''''''''" - after: "Classification:" - count: 6 - - paths: [ - packages/google-cloud-automl/google/cloud/automl_v1/types/io.py, - ] - before: | - AutoML Vision - \ \^\^\^\^\^\^\^\^\^\^\^\^\^ - after: | - AutoML Vision: - count: 2 - - paths: [ - packages/google-cloud-automl/google/cloud/automl_v1/types/io.py, - ] - before: | - AutoML Tables - \ \^\^\^\^\^\^\^\^\^\^\^\^\^ - after: | - AutoML Tables: - count: 2 - - paths: [ - packages/google-cloud-automl/google/cloud/automl_v1/types/io.py, - ] - before: | - AutoML Tables - \ \^\^\^\^\^\^\^\^\^\^\^\^\^ - after: | - AutoML Tables: - count: 1 - - paths: [ - packages/google-cloud-automl/google/cloud/automl_v1/types/io.py, - ] - before: "Entity Extraction\n '''''''''''''''''" - after: "Entity Extraction:" - count: 2 - - paths: [ - packages/google-cloud-automl/google/cloud/automl_v1/types/io.py, - ] - before: "Sentiment Analysis\n ''''''''''''''''''" - after: "Sentiment Analysis:" - count: 2 - - paths: [ - packages/google-cloud-automl/google/cloud/automl_v1/types/io.py, - ] - before: "Object Tracking\n '''''''''''''''" - after: "Object Tracking:" - count: 2 - - paths: [ - packages/google-cloud-automl/google/cloud/automl_v1/types/io.py, - ] - before: | - AutoML Video Intelligence - \ \^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^ - after: | - AutoML Video Intelligence: - count: 2 - - paths: [ - packages/google-cloud-automl/google/cloud/automl_v1/types/io.py, - ] - before: "Object Detection\n ''''''''''''''''" - after: "Object Detection:" - count: 2 - - paths: [ - packages/google-cloud-automl/google/cloud/automl_v1/types/io.py, - ] - before: | - AutoML Natural Language - \ \^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^\^ - after: | - AutoML Natural Language: - count: 2 - - paths: [ - packages/google-cloud-workflows/google/cloud/workflows_v1/types/workflows.py, - ] - before: | - The maximum number of revisions to return per - \ page. If a value is not specified, a default - \ value of 20 is used. The maximum permitted value - \ is - \ 100. Values greater than 100 are coerced down to - \ 100. - after: | - The maximum number of revisions to return per - page. If a value is not specified, a default - value of 20 is used. The maximum permitted value - is 100. Values greater than 100 are coerced down - to 100. - count: 1 - - paths: [ - packages/google-cloud-network-services/google/cloud/network_services_v1/types/service_lb_policy.py, - ] - before: | - Optional. If set to 'True', an unhealthy - \ IG/NEG will be set as drained. - \ - An IG/NEG is considered unhealthy if less than - after: | - Optional. If set to 'True', an unhealthy - IG/NEG will be set as drained.\n - - An IG/NEG is considered unhealthy if less than - count: 1 - - paths: [ - packages/google-cloud-discoveryengine/google/cloud/discoveryengine_v1/types/search_service.py, - packages/google-cloud-discoveryengine/google/cloud/discoveryengine_v1alpha/types/search_service.py, - packages/google-cloud-discoveryengine/google/cloud/discoveryengine_v1beta/types/search_service.py, - ] - before: | - Example #1 \(multi-turn /search API calls\): - \ - \ Call /search API with the session ID generated - \ in the first call. Here, the previous search - \ query gets considered in query standing. I.e., - \ if the first query is "How did Alphabet do in - \ 2022\?" and the current query is "How about - \ 2023\?", the current query will be interpreted - \ as "How did Alphabet do in 2023\?". - \ - \ Example #2 \(coordination between /search API - \ calls and /answer API calls\): - \ - \ Call /answer API with the session ID generated - \ in the first call. Here, the answer generation - \ happens in the context of the search results - \ from the first search call. - after: | - Example #1 (multi-turn /search API calls):\n - - Call /search API with the session ID generated - in the first call. Here, the previous search - query gets considered in query standing. I.e., - if the first query is "How did Alphabet do in - 2022?" and the current query is "How about - 2023?", the current query will be interpreted - as "How did Alphabet do in 2023?".\n - Example #2 (coordination between /search API - calls and /answer API calls):\n - - Call /answer API with the session ID generated - in the first call. Here, the answer generation - happens in the context of the search results - from the first search call. - count: 3 - - paths: [ - packages/google-cloud-maintenance-api/google/cloud/maintenance_api_v1beta/types/maintenance_service.py, - ] - before: | - user_controllable \(bool\): - \ Output only. Indicates whether the user has - \ some control over that maintenance, either - \ proactively before maintenance was scheduled - after: | - user_controllable (bool): - Output only. Indicates whether the user has - some control over that maintenance, either - proactively before maintenance was scheduled - count: 1 - - paths: [ - packages/google-cloud-dataplex/google/cloud/dataplex_v1/types/business_glossary.py, - ] - before: | - Examples of using a filter are: - \ -------------------------------\n - \ ``immediate_parent="projects/\{project_id_or_number\}/locations/\{location_id\}/glossaries/\{glossary_id\}"`` - \ -------------------------------------------------------------------------------------------------------\n - \ ``immediate_parent="projects/\{project_id_or_number\}/locations/\{location_id\}/glossaries/\{glossary_id\}/categories/\{category_id\}"`` - after: | - Examples of using a filter are:\n - - ``immediate_parent="projects/{project_id_or_number}/locations/{location_id}/glossaries/{glossary_id}"`` - - ``immediate_parent="projects/{project_id_or_number}/locations/{location_id}/glossaries/{glossary_id}/categories/{category_id}"`` - count: 2 - - paths: [ - packages/google-cloud-capacityplanner/google/cloud/capacityplanner_v1beta/types/usage_service.py, - ] - before: | - The format[\s]+is:\n - \ [\s]+projects/\{project\}/locations/\{location\} or - \ organizations/\{organization\}/locations/\{location\} - \ or[\s]+folders/\{folder\}/locations/\{location\} - after: | - The format is:\n - projects/{project}/locations/{location} or - organizations/{organization}/locations/{location} - or folders/{folder}/locations/{location} - count: 4 - - paths: [ - packages/google-maps-routeoptimization/google/maps/routeoptimization_v1/types/route_optimization_service.py, - ] - before: | - The ratio \(vehicle_end_time - vehicle_start_time\) / \(latest_vehicle_end_time - earliest_vehicle_start_time\) for a given vehicle. If the denominator is not present, it uses \(\[ShipmentModel.global_end_time\]\[google.maps.routeoptimization.v1.ShipmentModel.global_end_time\] - \ ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\n - \ \[ShipmentModel.global_start_time\]\[google.maps.routeoptimization.v1.ShipmentModel.global_start_time\]\) - \ instead. - after: | - The ratio (vehicle_end_time - vehicle_start_time) / (latest_vehicle_end_time - earliest_vehicle_start_time) for a given vehicle. If the denominator is not present, it uses - ([ShipmentModel.global_end_time][google.maps.routeoptimization.v1.ShipmentModel.global_end_time] - - [ShipmentModel.global_start_time][google.maps.routeoptimization.v1.ShipmentModel.global_start_time]) - instead. - count: 1