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[] = [];