chore(eslint): lint jsdocs (#33202)

Adds a dependency to `eslint-plugin-jsdoc` and utilizes the following linter rules (for now):

```
    'jsdoc/require-param-description': ['error'],
    'jsdoc/require-property-description': ['error'],
    'jsdoc/require-returns-description': ['error'],
```

These ensure that no one leaving `@param` or `@returns` without a description. In most cases, these are auto-generated and then the contributor forgets to add an actual description. They are useless without a description, so I am just removing the tags entirely. 

Our official stance is that these jsdoc tags are _optional_, but if you write them, they must have a description. 

### Checklist
- [x] My code adheres to the [CONTRIBUTING GUIDE](https://github.com/aws/aws-cdk/blob/main/CONTRIBUTING.md) and [DESIGN GUIDELINES](https://github.com/aws/aws-cdk/blob/main/docs/DESIGN_GUIDELINES.md)

----

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

Author: kaizencc

packages/@aws-cdk/aws-ec2-alpha/lib/util.ts

@@ -394,7 +394,6 @@ export class CidrBlockIpv6 {
   }
 
   /**
-   * @param ipv6Address
    * @returns Converts given ipv6 address range to big int number
    */
   private ipv6ToNumber(ipv6Address: string): bigint {

packages/@aws-cdk/aws-glue-alpha/lib/jobs/pyspark-streaming-job.ts

@@ -144,7 +144,6 @@ export class PySparkStreamingJob extends Job {
   /**
    * Set the executable arguments with best practices enabled by default
    *
-   * @param props
    * @returns An array of arguments for Glue to use on execution
    */
   private executableArguments(props: PySparkStreamingJobProps) {

packages/@aws-cdk/aws-scheduler-targets-alpha/lib/target.ts

@@ -91,7 +91,6 @@ export abstract class ScheduleTargetBase {
 
   /**
    * Create a return a Schedule Target Configuration for the given schedule
-   * @param schedule
    * @returns a Schedule Target Configuration
    */
   bind(schedule: ISchedule): ScheduleTargetConfig {

packages/@aws-cdk/cloudformation-diff/lib/diff/types.ts

@@ -420,7 +420,6 @@ export class DifferenceCollection<V, T extends IDifference<V>> {
    *  - Updated
    *  - Others
    *
-   * @param cb
    */
   public forEachDifference(cb: (logicalId: string, change: T) => any): void {
     const removed = new Array<{ logicalId: string; change: T }>();

packages/@aws-cdk/cloudformation-diff/lib/format.ts

@@ -345,7 +345,6 @@ export class Formatter {
     /**
      * Path is supposed to start with "/stack-name". If this is the case (i.e. path has more than
      * two components, we remove the first part. Otherwise, we just use the full path.
-     * @param p
      */
     function normalizePath(p: string) {
       if (p.startsWith('/')) {

packages/@aws-cdk/integ-runner/lib/cli.ts

@@ -284,7 +284,6 @@ export function cli(args: string[] = process.argv.slice(2)) {
 /**
  * Read CLI options from a config file if provided.
  *
- * @param fileName
  * @returns parsed CLI config options
  */
 function configFromFile(fileName?: string): Record<string, any> {

packages/@aws-cdk/toolkit/lib/api/cloud-assembly/stack-assembly.ts

@@ -15,7 +15,6 @@ export class StackAssembly extends CloudAssembly implements ICloudAssemblySource
 
   /**
    * Improved stack selection interface with a single selector
-   * @returns
    * @throws when the assembly does not contain any stacks, unless `selector.failOnEmpty` is `false`
    * @throws when individual selection strategies are not satisfied
    */

packages/aws-cdk-lib/aws-apigateway/lib/access-log.ts

@@ -375,8 +375,6 @@ export class AccessLogField {
    * The request header override.
    * If this parameter is defined, it contains the headers to be used instead of the HTTP Headers that are defined in the Integration Request pane.
    * @see https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-override-request-response-parameters.html
-   *
-   * @param headerName
    */
   public static contextRequestOverrideHeader(headerName: string) {
     return `$context.requestOverride.header.${headerName}`;
@@ -386,8 +384,6 @@ export class AccessLogField {
    * The request path override. If this parameter is defined,
    * it contains the request path to be used instead of the URL Path Parameters that are defined in the Integration Request pane.
    * @see https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-override-request-response-parameters.html
-   *
-   * @param pathName
    */
   public static contextRequestOverridePath(pathName: string) {
     return `$context.requestOverride.path.${pathName}`;
@@ -397,8 +393,6 @@ export class AccessLogField {
    * The request query string override.
    * If this parameter is defined, it contains the request query strings to be used instead
    * of the URL Query String Parameters that are defined in the Integration Request pane.
-   *
-   * @param querystringName
    */
   public static contextRequestOverrideQuerystring(querystringName: string) {
     return `$context.requestOverride.querystring.${querystringName}`;
@@ -409,8 +403,6 @@ export class AccessLogField {
    * If this parameter is defined, it contains the header to be returned instead of the Response header
    * that is defined as the Default mapping in the Integration Response pane.
    * @see https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-override-request-response-parameters.html
-   *
-   * @param headerName
    */
   public static contextResponseOverrideHeader(headerName: string) {
     return `$context.responseOverride.header.${headerName}`;
@@ -697,7 +689,6 @@ export class AccessLogFormat {
   /**
    * Custom log format.
    * You can create any log format string. You can easily get the $ context variable by using the methods of AccessLogField.
-   * @param format
    * @example
    *
    *  apigateway.AccessLogFormat.custom(JSON.stringify({

packages/aws-cdk-lib/aws-apigateway/lib/integrations/stepfunctions.ts

@@ -247,9 +247,6 @@ function integrationResponse() {
 
 /**
  * Defines the request template that will be used for the integration
- * @param stateMachine
- * @param options
- * @returns requestTemplate
  */
 function requestTemplates(stateMachine: sfn.IStateMachine, options: StepFunctionsExecutionIntegrationOptions) {
   const templateStr = templateString(stateMachine, options);
@@ -265,11 +262,6 @@ function requestTemplates(stateMachine: sfn.IStateMachine, options: StepFunction
 /**
  * Reads the VTL template and returns the template string to be used
  * for the request template.
- *
- * @param stateMachine
- * @param includeRequestContext
- * @param options
- * @reutrns templateString
  */
 function templateString(
   stateMachine: sfn.IStateMachine,

packages/aws-cdk-lib/aws-apigateway/lib/usage-plan.ts

@@ -261,16 +261,11 @@ export class UsagePlan extends UsagePlanBase {
 
   /**
    * Adds an apiStage.
-   * @param apiStage
    */
   public addApiStage(apiStage: UsagePlanPerApiStage) {
     this.apiStages.push(apiStage);
   }
 
-  /**
-   *
-   * @param props
-   */
   private renderApiStages(apiStages: UsagePlanPerApiStage[] | undefined): CfnUsagePlan.ApiStageProperty[] | undefined {
     if (apiStages && apiStages.length > 0) {
       const stages: CfnUsagePlan.ApiStageProperty[] = [];

packages/aws-cdk-lib/aws-apigatewayv2/lib/http/vpc-link.ts

@@ -108,17 +108,13 @@ export class VpcLink extends Resource implements IVpcLink {
 
   /**
    * Adds the provided subnets to the vpc link
-   *
-   * @param subnets
    */
   public addSubnets(...subnets: ec2.ISubnet[]) {
     this.subnets.push(...subnets);
   }
 
   /**
    * Adds the provided security groups to the vpc link
-   *
-   * @param groups
    */
   public addSecurityGroups(...groups: ec2.ISecurityGroup[]) {
     this.securityGroups.push(...groups);

packages/aws-cdk-lib/aws-appconfig/lib/configuration.ts

@@ -947,7 +947,6 @@ export abstract class ConfigurationSource {
    * Defines configuration content from AWS CodePipeline.
    *
    * @param pipeline The pipeline where the configuration is stored
-   * @returns
    */
   public static fromPipeline(pipeline: cp.IPipeline): ConfigurationSource {
     return {

packages/aws-cdk-lib/aws-appmesh/lib/service-discovery.ts

@@ -91,7 +91,6 @@ export abstract class ServiceDiscovery {
   /**
    * Returns DNS based service discovery
    *
-   * @param hostname
    * @param responseType Specifies the DNS response type for the virtual node.
    *  The default is `DnsResponseType.LOAD_BALANCER`.
    * @param ipPreference No IP preference is applied to the Virtual Node.

packages/aws-cdk-lib/aws-chatbot/lib/slack-channel-configuration.ts

@@ -167,7 +167,6 @@ abstract class SlackChannelConfigurationBase extends cdk.Resource implements ISl
 
   /**
    * Adds extra permission to iam-role of Slack channel configuration
-   * @param statement
    */
   public addToRolePolicy(statement: iam.PolicyStatement): void {
     if (!this.role) {
@@ -326,7 +325,6 @@ export class SlackChannelConfiguration extends SlackChannelConfigurationBase {
 
   /**
    * Adds a SNS topic that deliver notifications to AWS Chatbot.
-   * @param notificationTopic
    */
   public addNotificationTopic(notificationTopic: sns.ITopic): void {
     this.notificationTopics.push(notificationTopic);

packages/aws-cdk-lib/aws-ecs/lib/environment-file.ts

@@ -10,7 +10,6 @@ export abstract class EnvironmentFile {
    * Loads the environment file from a local disk path.
    *
    * @param path Local disk path
-   * @param options
    */
   public static fromAsset(path: string, options?: AssetOptions): AssetEnvironmentFile {
     return new AssetEnvironmentFile(path, options);
@@ -45,7 +44,6 @@ export class AssetEnvironmentFile extends EnvironmentFile {
 
   /**
    * @param path The path to the asset file or directory.
-   * @param options
    */
   constructor(public readonly path: string, private readonly options: AssetOptions = { }) {
     super();

packages/aws-cdk-lib/aws-sns/lib/subscription.ts

@@ -365,17 +365,13 @@ export enum FilterOrPolicyType {
 export abstract class FilterOrPolicy {
   /**
    * Filter of MessageBody
-   * @param filter
-   * @returns
    */
   public static filter(filter: SubscriptionFilter) {
     return new Filter(filter);
   }
 
   /**
    * Policy of MessageBody
-   * @param policy
-   * @returns
    */
   public static policy(policy: { [attribute: string]: FilterOrPolicy }) {
     return new Policy(policy);