chore(docs): remove {@link} everywhere (#23572)

The `{@link }` annotation doesn't work and has never worked, yet has cropped up in a lot of places in our docstrings, and it will only get worse as people look around and copy/paste.

Do a mass removal of the `{@link}` tags.

----

*By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license*

Author: rix0rrr

packages/@aws-cdk/aws-apigateway/lib/authorizers/lambda.ts

@@ -20,10 +20,10 @@ export interface LambdaAuthorizerProps {
   /**
    * The handler for the authorizer lambda function.
    *
-   * The handler must follow a very specific protocol on the input it receives and the output it needs to produce.
-   * API Gateway has documented the handler's input specification
-   * {@link https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-lambda-authorizer-input.html | here} and output specification
-   * {@link https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-lambda-authorizer-output.html | here}.
+   * The handler must follow a very specific protocol on the input it receives
+   * and the output it needs to produce.  API Gateway has documented the
+   * handler's [input specification](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-lambda-authorizer-input.html)
+   * and [output specification](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-lambda-authorizer-output.html).
    */
   readonly handler: lambda.IFunction;
 

packages/@aws-cdk/aws-apigateway/lib/lambda-api.ts

@@ -17,7 +17,7 @@ export interface LambdaRestApiProps extends RestApiProps {
   /**
    * Specific Lambda integration options.
    *
-   * @default see defaults defined in {@link LambdaIntegrationOptions}.
+   * @default see defaults defined in `LambdaIntegrationOptions`.
    */
   readonly integrationOptions?: LambdaIntegrationOptions;
 

packages/@aws-cdk/aws-apigateway/lib/method.ts

@@ -25,9 +25,9 @@ export interface MethodOptions {
    * Method authorization.
    * If the value is set of `Custom`, an `authorizer` must also be specified.
    *
-   * If you're using one of the authorizers that are available via the {@link Authorizer} class, such as {@link Authorizer#token()},
+   * If you're using one of the authorizers that are available via the `Authorizer` class, such as `Authorizer#token()`,
    * it is recommended that this option not be specified. The authorizer will take care of setting the correct authorization type.
-   * However, specifying an authorization type using this property that conflicts with what is expected by the {@link Authorizer}
+   * However, specifying an authorization type using this property that conflicts with what is expected by the `Authorizer`
    * will result in an error.
    *
    * @default - open access unless `authorizer` is specified

packages/@aws-cdk/aws-apigateway/lib/restapi.ts

@@ -616,7 +616,7 @@ export abstract class RestApiBase extends Resource implements IRestApi {
 /**
  * Represents a REST API in Amazon API Gateway, created with an OpenAPI specification.
  *
- * Some properties normally accessible on @see {@link RestApi} - such as the description -
+ * Some properties normally accessible on @see `RestApi` - such as the description -
  * must be declared in the specification. All Resources and Methods need to be defined as
  * part of the OpenAPI specification file, and cannot be added via the CDK.
  *

packages/@aws-cdk/aws-appmesh/lib/http-route-path-match.ts

@@ -2,7 +2,7 @@ import { Construct } from 'constructs';
 import { CfnGatewayRoute, CfnRoute } from './appmesh.generated';
 
 /**
- * The type returned from the `bind()` method in {@link HttpRoutePathMatch}.
+ * The type returned from the `bind()` method in `HttpRoutePathMatch`.
  */
 export interface HttpRoutePathMatchConfig {
   /**
@@ -94,7 +94,7 @@ class HttpRouteWholePathMatch extends HttpRoutePathMatch {
 }
 
 /**
- * The type returned from the `bind()` method in {@link HttpGatewayRoutePathMatch}.
+ * The type returned from the `bind()` method in `HttpGatewayRoutePathMatch`.
  */
 export interface HttpGatewayRoutePathMatchConfig {
   /**

packages/@aws-cdk/aws-appmesh/lib/tls-certificate.ts

@@ -3,7 +3,7 @@ import { Construct } from 'constructs';
 import { CfnVirtualNode } from './appmesh.generated';
 
 /**
- * A wrapper for the tls config returned by {@link TlsCertificate.bind}
+ * A wrapper for the tls config returned by `TlsCertificate.bind`
  */
 export interface TlsCertificateConfig {
   /**

packages/@aws-cdk/aws-autoscaling/lib/volume.ts

@@ -48,22 +48,22 @@ export interface EbsDeviceOptionsBase {
   /**
    * The number of I/O operations per second (IOPS) to provision for the volume.
    *
-   * Must only be set for {@link volumeType}: {@link EbsDeviceVolumeType.IO1}
+   * Must only be set for `volumeType`: `EbsDeviceVolumeType.IO1`
    *
    * The maximum ratio of IOPS to volume size (in GiB) is 50:1, so for 5,000 provisioned IOPS,
    * you need at least 100 GiB storage on the volume.
    *
    * @see https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSVolumeTypes.html
    *
-   * @default - none, required for {@link EbsDeviceVolumeType.IO1}
+   * @default - none, required for `EbsDeviceVolumeType.IO1`
    */
   readonly iops?: number;
 
   /**
    * The EBS volume type
    * @see https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSVolumeTypes.html
    *
-   * @default {@link EbsDeviceVolumeType.GP2}
+   * @default `EbsDeviceVolumeType.GP2`
    */
   readonly volumeType?: EbsDeviceVolumeType;
 

packages/@aws-cdk/aws-batch/lib/job-definition-image-config.ts

@@ -19,7 +19,7 @@ interface TaskDefinitionProps {
  * Batch Job Task Definition
  *
  * Defines a Batch Job Task Definition. The properties of this task definition mirrors
- * those of an {@link ecs.ContainerDefinition}. This class is a wrapper on that structure.
+ * those of an `ecs.ContainerDefinition`. This class is a wrapper on that structure.
  */
 class TaskDefinition {
   /**

packages/@aws-cdk/aws-batch/lib/job-definition.ts

@@ -244,7 +244,7 @@ export interface JobDefinitionContainer {
 }
 
 /**
- * Construction properties of the {@link JobDefinition} construct.
+ * Construction properties of the `JobDefinition` construct.
  */
 export interface JobDefinitionProps {
   /**
@@ -361,14 +361,14 @@ export interface INodeRangeProps {
    * to the number of nodes associated with the job. You may nest node ranges, for example 0:10 and 4:5,
    * in which case the 4:5 range properties override the 0:10 properties.
    *
-   * @default {@link IMultiNodeprops.count}
+   * @default `IMultiNodeprops.count`
    */
   toNodeIndex?: number;
 }
 
 /**
  * An interface representing a job definition - either a new one, created with the CDK, *using the
- * {@link JobDefinition} class, or existing ones, referenced using the {@link JobDefinition.fromJobDefinitionArn} method.
+ * `JobDefinition` class, or existing ones, referenced using the `JobDefinition.fromJobDefinitionArn` method.
  */
 export interface IJobDefinition extends IResource {
   /**

packages/@aws-cdk/aws-cloudformation/lib/custom-resource.ts

@@ -13,7 +13,7 @@ export type Properties = {[key: string]: any};
 /**
  * Configuration options for custom resource providers.
  *
- * @deprecated used in {@link ICustomResourceProvider} which is now deprecated
+ * @deprecated used in `ICustomResourceProvider` which is now deprecated
  */
 export interface CustomResourceProviderConfig {
   /**

packages/@aws-cdk/aws-cloudfront-origins/lib/origin-group.ts

@@ -1,7 +1,7 @@
 import * as cloudfront from '@aws-cdk/aws-cloudfront';
 import { Construct } from 'constructs';
 
-/** Construction properties for {@link OriginGroup}. */
+/** Construction properties for `OriginGroup`. */
 export interface OriginGroupProps {
   /**
    * The primary origin that should serve requests for this group.

packages/@aws-cdk/aws-cloudfront/lib/distribution.ts

@@ -707,7 +707,7 @@ export enum LambdaEdgeEventType {
 
 /**
  * Represents a Lambda function version and event type when using Lambda@Edge.
- * The type of the {@link AddBehaviorOptions.edgeLambdas} property.
+ * The type of the `AddBehaviorOptions.edgeLambdas` property.
  */
 export interface EdgeLambda {
   /**

packages/@aws-cdk/aws-cloudfront/lib/function.ts

@@ -202,7 +202,7 @@ export enum FunctionEventType {
 
 /**
  * Represents a CloudFront function and event type when using CF Functions.
- * The type of the {@link AddBehaviorOptions.functionAssociations} property.
+ * The type of the `AddBehaviorOptions.functionAssociations` property.
  */
 export interface FunctionAssociation {
   /**

packages/@aws-cdk/aws-cloudfront/lib/origin.ts

@@ -4,7 +4,7 @@ import { CfnDistribution } from './cloudfront.generated';
 
 /**
  * The failover configuration used for Origin Groups,
- * returned in {@link OriginBindConfig.failoverConfig}.
+ * returned in `OriginBindConfig.failoverConfig`.
  */
 export interface OriginFailoverConfig {
   /** The origin to use as the fallback origin. */
@@ -18,7 +18,7 @@ export interface OriginFailoverConfig {
   readonly statusCodes?: number[];
 }
 
-/** The struct returned from {@link IOrigin.bind}. */
+/** The struct returned from `IOrigin.bind`. */
 export interface OriginBindConfig {
   /**
    * The CloudFormation OriginProperty configuration for this Origin.

packages/@aws-cdk/aws-cloudfront/lib/web-distribution.ts

@@ -54,7 +54,7 @@ export enum FailoverStatusCode {
  * "cloudfront.net" domain. To use this feature you must provide the list of
  * additional domains, and the ACM Certificate that CloudFront should use for
  * these additional domains.
- * @deprecated see {@link CloudFrontWebDistributionProps#viewerCertificate} with {@link ViewerCertificate#acmCertificate}
+ * @deprecated see `CloudFrontWebDistributionProps#viewerCertificate` with `ViewerCertificate#acmCertificate`
  */
 export interface AliasConfiguration {
   /**
@@ -557,7 +557,7 @@ export class ViewerCertificate {
   /**
    * Generate a viewer certifcate configuration using
    * the CloudFront default certificate (e.g. d111111abcdef8.cloudfront.net)
-   * and a {@link SecurityPolicyProtocol.TLS_V1} security policy.
+   * and a `SecurityPolicyProtocol.TLS_V1` security policy.
    *
    * @param aliases Alternative CNAME aliases
    *                You also must create a CNAME record with your DNS service to route queries
@@ -577,7 +577,7 @@ export interface CloudFrontWebDistributionProps {
    * AliasConfiguration is used to configured CloudFront to respond to requests on custom domain names.
    *
    * @default - None.
-   * @deprecated see {@link CloudFrontWebDistributionProps#viewerCertificate} with {@link ViewerCertificate#acmCertificate}
+   * @deprecated see `CloudFrontWebDistributionProps#viewerCertificate` with `ViewerCertificate#acmCertificate`
    */
   readonly aliasConfiguration?: AliasConfiguration;
 

packages/@aws-cdk/aws-codebuild/lib/artifacts.ts

@@ -4,7 +4,7 @@ import { CfnProject } from './codebuild.generated';
 import { IProject } from './project';
 
 /**
- * The type returned from {@link IArtifacts#bind}.
+ * The type returned from `IArtifacts#bind`.
  */
 export interface ArtifactsConfig {
   /**
@@ -15,7 +15,7 @@ export interface ArtifactsConfig {
 
 /**
  * The abstract interface of a CodeBuild build output.
- * Implemented by {@link Artifacts}.
+ * Implemented by `Artifacts`.
  */
 export interface IArtifacts {
   /**
@@ -75,7 +75,7 @@ export abstract class Artifacts implements IArtifacts {
 }
 
 /**
- * Construction properties for {@link S3Artifacts}.
+ * Construction properties for `S3Artifacts`.
  */
 export interface S3ArtifactsProps extends ArtifactsProps {
   /**

packages/@aws-cdk/aws-codebuild/lib/file-location.ts

@@ -3,7 +3,7 @@ import { CfnProject } from './codebuild.generated';
 import { IProject } from './project';
 
 /**
- * The type returned from {@link IFileSystemLocation#bind}.
+ * The type returned from `IFileSystemLocation#bind`.
  */
 export interface FileSystemConfig {
   /**
@@ -15,7 +15,7 @@ export interface FileSystemConfig {
 
 /**
  * The interface of a CodeBuild FileSystemLocation.
- * Implemented by {@link EfsFileSystemLocation}.
+ * Implemented by `EfsFileSystemLocation`.
  */
 export interface IFileSystemLocation {
   /**
@@ -58,7 +58,7 @@ class EfsFileSystemLocation implements IFileSystemLocation {
 }
 
 /**
- * Construction properties for {@link EfsFileSystemLocation}.
+ * Construction properties for `EfsFileSystemLocation`.
  */
 export interface EfsFileSystemLocationProps {
   /**
@@ -83,4 +83,4 @@ export interface EfsFileSystemLocationProps {
    * The location in the container where you mount the file system.
    */
   readonly mountPoint: string;
-}
+}

packages/@aws-cdk/aws-codebuild/lib/linux-arm-build-image.ts

@@ -5,8 +5,8 @@ import { runScriptLinuxBuildSpec } from './private/run-script-linux-build-spec';
 import { BuildEnvironment, ComputeType, IBuildImage, ImagePullPrincipalType } from './project';
 
 /**
- * Construction properties of {@link LinuxArmBuildImage}.
- * Module-private, as the constructor of {@link LinuxArmBuildImage} is private.
+ * Construction properties of `LinuxArmBuildImage`.
+ * Module-private, as the constructor of `LinuxArmBuildImage` is private.
  */
 interface LinuxArmBuildImageProps {
   readonly imageId: string;