chore: require docstring on public members (#4645)

* chore: require docstring on public members Many people (still) contribute PRs with undocumented members, or undocumented classes, or undocumented defaults, because there is no tool support to check they're not forgetting. We used to have `@default` checking on props types for L2s, but not for interfaces that are used INSIDE L2 props structs, or that are used as props types for non-constructs. Add two new checks: * Requirement to document top-level types and public members. * Requirement to supply `@default` for optional properties on structs. Which supersede the previous one. Obviously, we have many currently undocumented APIs which are added to the ignore list. Fixes #2286. * Update region-info awslint script * Update with new undocumented APIs * More undefaulted props * Ignore some more undocumented public APIs that got merged in the mean time
aws · Oct 28, 2019 · dc8061a · dc8061a
1 parent 3459982
commit dc8061a
Show file tree

Hide file tree

Showing 65 changed files with 2,203 additions and 167 deletions.
diff --git a/packages/@aws-cdk/app-delivery/package.json b/packages/@aws-cdk/app-delivery/package.json
@@ -87,5 +87,14 @@
   "engines": {
     "node": ">= 10.3.0"
   },
-  "stability": "experimental"
-}
+  "stability": "experimental",
+  "awslint": {
+    "exclude": [
+      "docs-public-apis:@aws-cdk/app-delivery.PipelineDeployStackAction.actionProperties",
+      "docs-public-apis:@aws-cdk/app-delivery.PipelineDeployStackAction.deploymentRole",
+      "docs-public-apis:@aws-cdk/app-delivery.PipelineDeployStackAction.bind",
+      "docs-public-apis:@aws-cdk/app-delivery.PipelineDeployStackAction.onStateChange",
+      "docs-public-apis:@aws-cdk/app-delivery.PipelineDeployStackActionProps"
+    ]
+  }
+}
diff --git a/packages/@aws-cdk/assets/package.json b/packages/@aws-cdk/assets/package.json
@@ -90,5 +90,12 @@
   "bundledDependencies": [
     "minimatch"
   ],
-  "stability": "experimental"
-}
+  "stability": "experimental",
+  "awslint": {
+    "exclude": [
+      "docs-public-apis:@aws-cdk/assets.StagingProps",
+      "docs-public-apis:@aws-cdk/assets.StagingProps.sourcePath",
+      "docs-public-apis:@aws-cdk/assets.FollowMode"
+    ]
+  }
+}
diff --git a/packages/@aws-cdk/aws-apigateway/package.json b/packages/@aws-cdk/aws-apigateway/package.json
@@ -106,8 +106,186 @@
       "props-physical-name:@aws-cdk/aws-apigateway.BasePathMappingProps",
       "props-physical-name:@aws-cdk/aws-apigateway.LambdaRestApiProps",
       "construct-interface-extends-iconstruct:@aws-cdk/aws-apigateway.IModel",
-      "resource-interface-extends-resource:@aws-cdk/aws-apigateway.IModel"
+      "resource-interface-extends-resource:@aws-cdk/aws-apigateway.IModel",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.definitions",
+      "docs-public-apis:@aws-cdk/aws-apigateway.Period.MONTH",
+      "docs-public-apis:@aws-cdk/aws-apigateway.Period.WEEK",
+      "docs-public-apis:@aws-cdk/aws-apigateway.Period.DAY",
+      "docs-public-apis:@aws-cdk/aws-apigateway.PassthroughBehavior",
+      "docs-public-apis:@aws-cdk/aws-apigateway.MethodLoggingLevel.INFO",
+      "docs-public-apis:@aws-cdk/aws-apigateway.MethodLoggingLevel.ERROR",
+      "docs-public-apis:@aws-cdk/aws-apigateway.MethodLoggingLevel.OFF",
+      "docs-public-apis:@aws-cdk/aws-apigateway.MethodLoggingLevel",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchemaVersion.DRAFT7",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchemaVersion",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchemaType.STRING",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchemaType.INTEGER",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchemaType.NUMBER",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchemaType.ARRAY",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchemaType.OBJECT",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchemaType.BOOLEAN",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchemaType.NULL",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchemaType",
+      "docs-public-apis:@aws-cdk/aws-apigateway.IntegrationType",
+      "docs-public-apis:@aws-cdk/aws-apigateway.EndpointType",
+      "docs-public-apis:@aws-cdk/aws-apigateway.ContentHandling",
+      "docs-public-apis:@aws-cdk/aws-apigateway.ConnectionType",
+      "docs-public-apis:@aws-cdk/aws-apigateway.AuthorizationType",
+      "docs-public-apis:@aws-cdk/aws-apigateway.ApiKeySourceType",
+      "docs-public-apis:@aws-cdk/aws-apigateway.UsagePlanProps",
+      "docs-public-apis:@aws-cdk/aws-apigateway.UsagePlanPerApiStage.throttle",
+      "docs-public-apis:@aws-cdk/aws-apigateway.UsagePlanPerApiStage.api",
+      "docs-public-apis:@aws-cdk/aws-apigateway.StageProps",
+      "docs-public-apis:@aws-cdk/aws-apigateway.StageOptions",
+      "docs-public-apis:@aws-cdk/aws-apigateway.RestApiProps",
+      "docs-public-apis:@aws-cdk/aws-apigateway.ResourceProps",
+      "docs-public-apis:@aws-cdk/aws-apigateway.ResourceOptions",
+      "docs-public-apis:@aws-cdk/aws-apigateway.RequestValidatorProps",
+      "docs-public-apis:@aws-cdk/aws-apigateway.RequestValidatorOptions",
+      "docs-public-apis:@aws-cdk/aws-apigateway.ProxyResourceProps",
+      "docs-public-apis:@aws-cdk/aws-apigateway.ProxyResourceOptions",
+      "docs-public-apis:@aws-cdk/aws-apigateway.ModelProps",
+      "docs-public-apis:@aws-cdk/aws-apigateway.ModelOptions",
+      "docs-public-apis:@aws-cdk/aws-apigateway.MethodResponse",
+      "docs-public-apis:@aws-cdk/aws-apigateway.Cors",
+      "docs-public-apis:@aws-cdk/aws-apigateway.Deployment.api",
+      "docs-public-apis:@aws-cdk/aws-apigateway.Deployment.deploymentId",
+      "docs-public-apis:@aws-cdk/aws-apigateway.DomainName",
+      "docs-public-apis:@aws-cdk/aws-apigateway.Method",
+      "docs-public-apis:@aws-cdk/aws-apigateway.Method.httpMethod",
+      "docs-public-apis:@aws-cdk/aws-apigateway.Method.methodId",
+      "docs-public-apis:@aws-cdk/aws-apigateway.Method.resource",
+      "docs-public-apis:@aws-cdk/aws-apigateway.Method.restApi",
+      "docs-public-apis:@aws-cdk/aws-apigateway.Model",
+      "docs-public-apis:@aws-cdk/aws-apigateway.Model.fromModelName",
+      "docs-public-apis:@aws-cdk/aws-apigateway.RequestValidator",
+      "docs-public-apis:@aws-cdk/aws-apigateway.RequestValidator.fromRequestValidatorId",
+      "docs-public-apis:@aws-cdk/aws-apigateway.Resource",
+      "docs-public-apis:@aws-cdk/aws-apigateway.ResourceBase",
+      "docs-public-apis:@aws-cdk/aws-apigateway.RestApi.fromRestApiId",
+      "docs-public-apis:@aws-cdk/aws-apigateway.RestApi.arnForExecuteApi",
+      "docs-public-apis:@aws-cdk/aws-apigateway.Stage",
+      "docs-public-apis:@aws-cdk/aws-apigateway.Stage.restApi",
+      "docs-public-apis:@aws-cdk/aws-apigateway.Stage.stageName",
+      "docs-public-apis:@aws-cdk/aws-apigateway.UsagePlan",
+      "docs-public-apis:@aws-cdk/aws-apigateway.UsagePlan.usagePlanId",
+      "docs-public-apis:@aws-cdk/aws-apigateway.VpcLink.addTargets",
+      "docs-public-apis:@aws-cdk/aws-apigateway.AwsIntegrationProps",
+      "props-default-doc:@aws-cdk/aws-apigateway.AwsIntegrationProps.action",
+      "props-default-doc:@aws-cdk/aws-apigateway.AwsIntegrationProps.actionParameters",
+      "props-default-doc:@aws-cdk/aws-apigateway.AwsIntegrationProps.options",
+      "props-default-doc:@aws-cdk/aws-apigateway.AwsIntegrationProps.path",
+      "props-default-doc:@aws-cdk/aws-apigateway.AwsIntegrationProps.subdomain",
+      "docs-public-apis:@aws-cdk/aws-apigateway.BasePathMappingOptions",
+      "docs-public-apis:@aws-cdk/aws-apigateway.BasePathMappingProps",
+      "docs-public-apis:@aws-cdk/aws-apigateway.CorsOptions",
+      "docs-public-apis:@aws-cdk/aws-apigateway.DeploymentProps",
+      "docs-public-apis:@aws-cdk/aws-apigateway.DomainNameAttributes",
+      "docs-public-apis:@aws-cdk/aws-apigateway.DomainNameOptions",
+      "docs-public-apis:@aws-cdk/aws-apigateway.DomainNameProps",
+      "docs-public-apis:@aws-cdk/aws-apigateway.HttpIntegrationProps",
+      "docs-public-apis:@aws-cdk/aws-apigateway.IDomainName",
+      "docs-public-apis:@aws-cdk/aws-apigateway.IModel",
+      "docs-public-apis:@aws-cdk/aws-apigateway.IRequestValidator",
+      "docs-public-apis:@aws-cdk/aws-apigateway.IResource",
+      "docs-public-apis:@aws-cdk/aws-apigateway.IRestApi",
+      "docs-public-apis:@aws-cdk/aws-apigateway.IntegrationOptions",
+      "props-default-doc:@aws-cdk/aws-apigateway.IntegrationOptions.cacheKeyParameters",
+      "props-default-doc:@aws-cdk/aws-apigateway.IntegrationOptions.cacheNamespace",
+      "props-default-doc:@aws-cdk/aws-apigateway.IntegrationOptions.integrationResponses",
+      "props-default-doc:@aws-cdk/aws-apigateway.IntegrationOptions.passthroughBehavior",
+      "props-default-doc:@aws-cdk/aws-apigateway.IntegrationOptions.requestParameters",
+      "props-default-doc:@aws-cdk/aws-apigateway.IntegrationOptions.requestTemplates",
+      "props-default-doc:@aws-cdk/aws-apigateway.IntegrationOptions.vpcLink",
+      "docs-public-apis:@aws-cdk/aws-apigateway.IntegrationProps",
+      "props-default-doc:@aws-cdk/aws-apigateway.IntegrationProps.integrationHttpMethod",
+      "props-default-doc:@aws-cdk/aws-apigateway.IntegrationProps.options",
+      "props-default-doc:@aws-cdk/aws-apigateway.IntegrationProps.uri",
+      "docs-public-apis:@aws-cdk/aws-apigateway.IntegrationResponse",
+      "props-default-doc:@aws-cdk/aws-apigateway.IntegrationResponse.responseParameters",
+      "props-default-doc:@aws-cdk/aws-apigateway.IntegrationResponse.responseTemplates",
+      "props-default-doc:@aws-cdk/aws-apigateway.IntegrationResponse.selectionPattern",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.additionalItems",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.additionalItems",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.additionalProperties",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.additionalProperties",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.allOf",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.allOf",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.anyOf",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.anyOf",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.contains",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.contains",
+      "docs-public-apis:@aws-cdk/aws-apigateway.MethodProps",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.definitions",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.dependencies",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.dependencies",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.description",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.description",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.enum",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.enum",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.exclusiveMaximum",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.exclusiveMaximum",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.exclusiveMinimum",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.exclusiveMinimum",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.format",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.format",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.id",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.id",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.items",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.items",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.maximum",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.maximum",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.maxItems",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.maxItems",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.maxLength",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.maxLength",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.maxProperties",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.maxProperties",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.minimum",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.minimum",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.minItems",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.minItems",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.minLength",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.minLength",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.minProperties",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.minProperties",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.multipleOf",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.multipleOf",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.not",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.not",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.oneOf",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.oneOf",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.pattern",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.pattern",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.patternProperties",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.patternProperties",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.properties",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.properties",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.propertyNames",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.propertyNames",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.ref",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.ref",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.required",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.required",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.schema",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.schema",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.title",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.title",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.type",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.type",
+      "docs-public-apis:@aws-cdk/aws-apigateway.JsonSchema.uniqueItems",
+      "props-default-doc:@aws-cdk/aws-apigateway.JsonSchema.uniqueItems",
+      "docs-public-apis:@aws-cdk/aws-apigateway.LambdaIntegrationOptions",
+      "docs-public-apis:@aws-cdk/aws-apigateway.LambdaRestApiProps",
+      "docs-public-apis:@aws-cdk/aws-apigateway.LambdaRestApiProps.options",
+      "docs-public-apis:@aws-cdk/aws-apigateway.MethodDeploymentOptions",
+      "docs-public-apis:@aws-cdk/aws-apigateway.MethodOptions",
+      "props-default-doc:@aws-cdk/aws-apigateway.MethodOptions.authorizer",
+      "props-default-doc:@aws-cdk/aws-apigateway.MethodOptions.operationName",
+      "props-default-doc:@aws-cdk/aws-apigateway.MethodOptions.requestModels",
+      "props-default-doc:@aws-cdk/aws-apigateway.MethodOptions.requestValidator",
+      "docs-public-apis:@aws-cdk/aws-apigateway.ResourceBase.url"
     ]
   },
   "stability": "stable"
-}
+}
diff --git a/packages/@aws-cdk/aws-applicationautoscaling/package.json b/packages/@aws-cdk/aws-applicationautoscaling/package.json
@@ -87,8 +87,30 @@
   },
   "awslint": {
     "exclude": [
-      "props-physical-name:@aws-cdk/aws-applicationautoscaling.ScalableTargetProps"
+      "props-physical-name:@aws-cdk/aws-applicationautoscaling.ScalableTargetProps",
+      "docs-public-apis:@aws-cdk/aws-applicationautoscaling.TargetTrackingScalingPolicyProps.scalingTarget",
+      "docs-public-apis:@aws-cdk/aws-applicationautoscaling.PredefinedMetric.ECS_SERVICE_AVERAGE_MEMORY_UTILIZATION",
+      "docs-public-apis:@aws-cdk/aws-applicationautoscaling.ScalableTarget.fromScalableTargetId",
+      "docs-public-apis:@aws-cdk/aws-applicationautoscaling.StepScalingPolicy.lowerAction",
+      "docs-public-apis:@aws-cdk/aws-applicationautoscaling.StepScalingPolicy.lowerAlarm",
+      "docs-public-apis:@aws-cdk/aws-applicationautoscaling.StepScalingPolicy.upperAction",
+      "docs-public-apis:@aws-cdk/aws-applicationautoscaling.StepScalingPolicy.upperAlarm",
+      "docs-public-apis:@aws-cdk/aws-applicationautoscaling.TargetTrackingScalingPolicy",
+      "docs-public-apis:@aws-cdk/aws-applicationautoscaling.BasicStepScalingPolicyProps",
+      "docs-public-apis:@aws-cdk/aws-applicationautoscaling.IScalableTarget",
+      "docs-public-apis:@aws-cdk/aws-applicationautoscaling.IScalableTarget.scalableTargetId",
+      "docs-public-apis:@aws-cdk/aws-applicationautoscaling.StepScalingPolicyProps",
+      "docs-public-apis:@aws-cdk/aws-applicationautoscaling.PredefinedMetric.ECS_SERVICE_AVERAGE_CPU_UTILIZATION",
+      "docs-public-apis:@aws-cdk/aws-applicationautoscaling.PredefinedMetric.DYNAMODB_READ_CAPACITY_UTILIZATION",
+      "docs-public-apis:@aws-cdk/aws-applicationautoscaling.PredefinedMetric.DYANMODB_WRITE_CAPACITY_UTILIZATION",
+      "docs-public-apis:@aws-cdk/aws-applicationautoscaling.PredefinedMetric.ALB_REQUEST_COUNT_PER_TARGET",
+      "docs-public-apis:@aws-cdk/aws-applicationautoscaling.PredefinedMetric.RDS_READER_AVERAGE_CPU_UTILIZATION",
+      "docs-public-apis:@aws-cdk/aws-applicationautoscaling.PredefinedMetric.RDS_READER_AVERAGE_DATABASE_CONNECTIONS",
+      "docs-public-apis:@aws-cdk/aws-applicationautoscaling.PredefinedMetric.EC2_SPOT_FLEET_REQUEST_AVERAGE_CPU_UTILIZATION",
+      "docs-public-apis:@aws-cdk/aws-applicationautoscaling.PredefinedMetric.EC2_SPOT_FLEET_REQUEST_AVERAGE_NETWORK_IN",
+      "docs-public-apis:@aws-cdk/aws-applicationautoscaling.PredefinedMetric.EC2_SPOT_FLEET_REQUEST_AVERAGE_NETWORK_OUT",
+      "docs-public-apis:@aws-cdk/aws-applicationautoscaling.PredefinedMetric.SAGEMAKER_VARIANT_INVOCATIONS_PER_INSTANCE"
     ]
   },
   "stability": "stable"
-}
+}
diff --git a/packages/@aws-cdk/aws-appmesh/package.json b/packages/@aws-cdk/aws-appmesh/package.json
@@ -111,8 +111,15 @@
       "resource-attribute:@aws-cdk/aws-appmesh.VirtualRouter.virtualRouterMeshName",
       "resource-attribute:@aws-cdk/aws-appmesh.VirtualRouter.virtualRouterUid",
       "resource-attribute:@aws-cdk/aws-appmesh.VirtualService.virtualServiceMeshName",
-      "resource-attribute:@aws-cdk/aws-appmesh.VirtualService.virtualServiceUid"
+      "resource-attribute:@aws-cdk/aws-appmesh.VirtualService.virtualServiceUid",
+      "docs-public-apis:@aws-cdk/aws-appmesh.Protocol.TCP",
+      "docs-public-apis:@aws-cdk/aws-appmesh.VirtualRouter",
+      "props-default-doc:@aws-cdk/aws-appmesh.VirtualRouterAttributes.mesh",
+      "props-default-doc:@aws-cdk/aws-appmesh.VirtualRouterAttributes.meshName",
+      "props-default-doc:@aws-cdk/aws-appmesh.VirtualRouterAttributes.virtualRouterArn",
+      "props-default-doc:@aws-cdk/aws-appmesh.VirtualRouterAttributes.virtualRouterName",
+      "docs-public-apis:@aws-cdk/aws-appmesh.Protocol.HTTP"
     ]
   },
   "stability": "experimental"
-}
+}
diff --git a/packages/@aws-cdk/aws-autoscaling-common/package.json b/packages/@aws-cdk/aws-autoscaling-common/package.json
@@ -76,11 +76,27 @@
   },
   "awslint": {
     "exclude": [
-      "no-unused-type:@aws-cdk/aws-autoscaling-common.*"
+      "no-unused-type:@aws-cdk/aws-autoscaling-common.*",
+      "docs-public-apis:@aws-cdk/aws-autoscaling-common.ArbitraryIntervals",
+      "docs-public-apis:@aws-cdk/aws-autoscaling-common.IRandomGenerator.nextInt",
+      "docs-public-apis:@aws-cdk/aws-autoscaling-common.IRandomGenerator.nextBoolean",
+      "docs-public-apis:@aws-cdk/aws-autoscaling-common.IRandomGenerator",
+      "props-default-doc:@aws-cdk/aws-autoscaling-common.CompleteScalingInterval.change",
+      "docs-public-apis:@aws-cdk/aws-autoscaling-common.Alarms",
+      "docs-public-apis:@aws-cdk/aws-autoscaling-common.Alarms.lowerAlarmIntervalIndex",
+      "props-default-doc:@aws-cdk/aws-autoscaling-common.Alarms.lowerAlarmIntervalIndex",
+      "docs-public-apis:@aws-cdk/aws-autoscaling-common.Alarms.upperAlarmIntervalIndex",
+      "props-default-doc:@aws-cdk/aws-autoscaling-common.Alarms.upperAlarmIntervalIndex",
+      "docs-public-apis:@aws-cdk/aws-autoscaling-common.CompleteScalingInterval.change",
+      "docs-public-apis:@aws-cdk/aws-autoscaling-common.ArbitraryIntervals.absolute",
+      "docs-public-apis:@aws-cdk/aws-autoscaling-common.ArbitraryIntervals.intervals",
+      "docs-public-apis:@aws-cdk/aws-autoscaling-common.CompleteScalingInterval",
+      "docs-public-apis:@aws-cdk/aws-autoscaling-common.CompleteScalingInterval.lower",
+      "docs-public-apis:@aws-cdk/aws-autoscaling-common.CompleteScalingInterval.upper"
     ]
   },
   "engines": {
     "node": ">= 10.3.0"
   },
   "stability": "experimental"
-}
+}