fix: replace markdown links with tsdoc compatible link tags (#1361)

* fix: replace markdown links with tsdoc compatible links

This applies to links that are hard-coded into the template.

* update baselines

baselines/asset/src/v1/asset_service_client.ts.baseline

@@ -366,8 +366,7 @@ export class AssetServiceClient {
  * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
  * @returns {Promise} - The promise which resolves to an array.
  * The first element of the array is an object representing {@link protos.google.cloud.asset.v1.BatchGetAssetsHistoryResponse|BatchGetAssetsHistoryResponse}.
- * Please see the
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
  * for more details and examples.
  * @example <caption>include:samples/generated/v1/asset_service.batch_get_assets_history.js</caption>
  * region_tag:cloudasset_v1_generated_AssetService_BatchGetAssetsHistory_async
@@ -451,8 +450,7 @@ export class AssetServiceClient {
  * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
  * @returns {Promise} - The promise which resolves to an array.
  * The first element of the array is an object representing {@link protos.google.cloud.asset.v1.Feed|Feed}.
- * Please see the
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
  * for more details and examples.
  * @example <caption>include:samples/generated/v1/asset_service.create_feed.js</caption>
  * region_tag:cloudasset_v1_generated_AssetService_CreateFeed_async
@@ -525,8 +523,7 @@ export class AssetServiceClient {
  * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
  * @returns {Promise} - The promise which resolves to an array.
  * The first element of the array is an object representing {@link protos.google.cloud.asset.v1.Feed|Feed}.
- * Please see the
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
  * for more details and examples.
  * @example <caption>include:samples/generated/v1/asset_service.get_feed.js</caption>
  * region_tag:cloudasset_v1_generated_AssetService_GetFeed_async
@@ -598,8 +595,7 @@ export class AssetServiceClient {
  * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
  * @returns {Promise} - The promise which resolves to an array.
  * The first element of the array is an object representing {@link protos.google.cloud.asset.v1.ListFeedsResponse|ListFeedsResponse}.
- * Please see the
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
  * for more details and examples.
  * @example <caption>include:samples/generated/v1/asset_service.list_feeds.js</caption>
  * region_tag:cloudasset_v1_generated_AssetService_ListFeeds_async
@@ -677,8 +673,7 @@ export class AssetServiceClient {
  * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
  * @returns {Promise} - The promise which resolves to an array.
  * The first element of the array is an object representing {@link protos.google.cloud.asset.v1.Feed|Feed}.
- * Please see the
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
  * for more details and examples.
  * @example <caption>include:samples/generated/v1/asset_service.update_feed.js</caption>
  * region_tag:cloudasset_v1_generated_AssetService_UpdateFeed_async
@@ -751,8 +746,7 @@ export class AssetServiceClient {
  * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
  * @returns {Promise} - The promise which resolves to an array.
  * The first element of the array is an object representing {@link protos.google.protobuf.Empty|Empty}.
- * Please see the
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
  * for more details and examples.
  * @example <caption>include:samples/generated/v1/asset_service.delete_feed.js</caption>
  * region_tag:cloudasset_v1_generated_AssetService_DeleteFeed_async
@@ -849,8 +843,7 @@ export class AssetServiceClient {
  * The first element of the array is an object representing
  * a long running operation. Its `promise()` method returns a promise
  * you can `await` for.
- * Please see the
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
  * for more details and examples.
  * @example <caption>include:samples/generated/v1/asset_service.export_assets.js</caption>
  * region_tag:cloudasset_v1_generated_AssetService_ExportAssets_async
@@ -915,8 +908,7 @@ export class AssetServiceClient {
  * The operation name that will be passed.
  * @returns {Promise} - The promise which resolves to an object.
  * The decoded operation object has result and metadata field to get information from.
- * Please see the
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
  * for more details and examples.
  * @example <caption>include:samples/generated/v1/asset_service.export_assets.js</caption>
  * region_tag:cloudasset_v1_generated_AssetService_ExportAssets_async

baselines/bigquery-storage/src/v1beta1/big_query_storage_client.ts.baseline

@@ -358,8 +358,7 @@ export class BigQueryStorageClient {
  * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
  * @returns {Promise} - The promise which resolves to an array.
  * The first element of the array is an object representing {@link protos.google.cloud.bigquery.storage.v1beta1.ReadSession|ReadSession}.
- * Please see the
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
  * for more details and examples.
  * @example <caption>include:samples/generated/v1beta1/big_query_storage.create_read_session.js</caption>
  * region_tag:bigquerystorage_v1beta1_generated_BigQueryStorage_CreateReadSession_async
@@ -437,8 +436,7 @@ export class BigQueryStorageClient {
  * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
  * @returns {Promise} - The promise which resolves to an array.
  * The first element of the array is an object representing {@link protos.google.cloud.bigquery.storage.v1beta1.BatchCreateReadSessionStreamsResponse|BatchCreateReadSessionStreamsResponse}.
- * Please see the
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
  * for more details and examples.
  * @example <caption>include:samples/generated/v1beta1/big_query_storage.batch_create_read_session_streams.js</caption>
  * region_tag:bigquerystorage_v1beta1_generated_BigQueryStorage_BatchCreateReadSessionStreams_async
@@ -521,8 +519,7 @@ export class BigQueryStorageClient {
  * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
  * @returns {Promise} - The promise which resolves to an array.
  * The first element of the array is an object representing {@link protos.google.protobuf.Empty|Empty}.
- * Please see the
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
  * for more details and examples.
  * @example <caption>include:samples/generated/v1beta1/big_query_storage.finalize_stream.js</caption>
  * region_tag:bigquerystorage_v1beta1_generated_BigQueryStorage_FinalizeStream_async
@@ -612,8 +609,7 @@ export class BigQueryStorageClient {
  * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
  * @returns {Promise} - The promise which resolves to an array.
  * The first element of the array is an object representing {@link protos.google.cloud.bigquery.storage.v1beta1.SplitReadStreamResponse|SplitReadStreamResponse}.
- * Please see the
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
  * for more details and examples.
  * @example <caption>include:samples/generated/v1beta1/big_query_storage.split_read_stream.js</caption>
  * region_tag:bigquerystorage_v1beta1_generated_BigQueryStorage_SplitReadStream_async
@@ -694,8 +690,7 @@ export class BigQueryStorageClient {
  * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
  * @returns {Stream}
  * An object stream which emits {@link protos.google.cloud.bigquery.storage.v1beta1.ReadRowsResponse|ReadRowsResponse} on 'data' event.
- * Please see the
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#server-streaming)
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#server-streaming | documentation }
  * for more details and examples.
  * @example <caption>include:samples/generated/v1beta1/big_query_storage.read_rows.js</caption>
  * region_tag:bigquerystorage_v1beta1_generated_BigQueryStorage_ReadRows_async

baselines/compute/src/v1/addresses_client.ts.baseline

@@ -324,8 +324,7 @@ export class AddressesClient {
  * @returns {Promise} - The promise which resolves to an array.
  * The first element of the array is an object representing
  * a long running operation.
- * Please see the
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
  * for more details and examples.
  * This method is considered to be in beta. This means while
  * stable it is still a work-in-progress and under active development,
@@ -419,8 +418,7 @@ export class AddressesClient {
  * @returns {Promise} - The promise which resolves to an array.
  * The first element of the array is an object representing
  * a long running operation.
- * Please see the
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
  * for more details and examples.
  * This method is considered to be in beta. This means while
  * stable it is still a work-in-progress and under active development,
@@ -524,12 +522,11 @@ export class AddressesClient {
  * @param {object} [options]
  * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
  * @returns {Object}
- * An iterable Object that allows [async iteration](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols).
+ * An iterable Object that allows {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols | async iteration }.
  * When you iterate the returned iterable, each element will be an object representing
  * as tuple [string, {@link protos.google.cloud.compute.v1.AddressesScopedList|AddressesScopedList}]. The API will be called under the hood as needed, once per the page,
  * so you can stop the iteration when you don't need more results.
- * Please see the
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination)
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
  * for more details and examples.
  * @example <caption>include:samples/generated/v1/addresses.aggregated_list.js</caption>
  * region_tag:compute_v1_generated_Addresses_AggregatedList_async
@@ -592,8 +589,7 @@ export class AddressesClient {
  * Note that it can affect your quota.
  * We recommend using `listAsync()`
  * method described below for async iteration which you can stop as needed.
- * Please see the
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination)
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
  * for more details and examples.
  */
  list(
@@ -688,8 +684,7 @@ export class AddressesClient {
  * times as needed. Note that it can affect your quota.
  * We recommend using `listAsync()`
  * method described below for async iteration which you can stop as needed.
- * Please see the
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination)
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
  * for more details and examples.
  */
  listStream(
@@ -747,12 +742,11 @@ export class AddressesClient {
  * @param {object} [options]
  * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
  * @returns {Object}
- * An iterable Object that allows [async iteration](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols).
+ * An iterable Object that allows {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols | async iteration }.
  * When you iterate the returned iterable, each element will be an object representing
  * {@link protos.google.cloud.compute.v1.Address|Address}. The API will be called under the hood as needed, once per the page,
  * so you can stop the iteration when you don't need more results.
- * Please see the
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination)
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
  * for more details and examples.
  * @example <caption>include:samples/generated/v1/addresses.list.js</caption>
  * region_tag:compute_v1_generated_Addresses_List_async

baselines/compute/src/v1/region_operations_client.ts.baseline

@@ -304,8 +304,7 @@ export class RegionOperationsClient {
  * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
  * @returns {Promise} - The promise which resolves to an array.
  * The first element of the array is an object representing {@link protos.google.cloud.compute.v1.Operation|Operation}.
- * Please see the
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
  * for more details and examples.
  * @example <caption>include:samples/generated/v1/region_operations.get.js</caption>
  * region_tag:compute_v1_generated_RegionOperations_Get_async
@@ -385,8 +384,7 @@ export class RegionOperationsClient {
  * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
  * @returns {Promise} - The promise which resolves to an array.
  * The first element of the array is an object representing {@link protos.google.cloud.compute.v1.Operation|Operation}.
- * Please see the
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
  * for more details and examples.
  * @example <caption>include:samples/generated/v1/region_operations.wait.js</caption>
  * region_tag:compute_v1_generated_RegionOperations_Wait_async

baselines/deprecatedtest/src/v1/deprecated_service_client.ts.baseline

@@ -299,8 +299,7 @@ export class DeprecatedServiceClient {
  * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
  * @returns {Promise} - The promise which resolves to an array.
  * The first element of the array is an object representing {@link protos.google.protobuf.Empty|Empty}.
- * Please see the
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
  * for more details and examples.
  * @example <caption>include:samples/generated/v1/deprecated_service.fast_fibonacci.js</caption>
  * region_tag:localhost_v1_generated_DeprecatedService_FastFibonacci_async
@@ -365,8 +364,7 @@ export class DeprecatedServiceClient {
  * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
  * @returns {Promise} - The promise which resolves to an array.
  * The first element of the array is an object representing {@link protos.google.protobuf.Empty|Empty}.
- * Please see the
- * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
  * for more details and examples.
  * @example <caption>include:samples/generated/v1/deprecated_service.slow_fibonacci.js</caption>
  * region_tag:localhost_v1_generated_DeprecatedService_SlowFibonacci_async