docs: fix "it's" to "its" (possessive) in source comments

Fix incorrect use of "it's" (contraction of "it is") where "its"
(possessive) is intended:
- aws-apigateway: "calculating it's hash" (3 files)
- aws-s3: "bucket and it's contents" (bucket-grants.ts, bucket.ts)
- core: "reference to it's parent" (stack.ts)
- cx-api: "Despite it's name" (cxapi.ts)

Author: syukawa-dev

packages/aws-cdk-lib/aws-apigateway/lib/model.ts

@@ -105,7 +105,7 @@ export interface ModelProps extends ModelOptions {
    * The rest API that this model is part of.
    *
    * The reason we need the RestApi object itself and not just the ID is because the model
-   * is being tracked by the top-level RestApi object for the purpose of calculating it's
+   * is being tracked by the top-level RestApi object for the purpose of calculating its
    * hash to determine the ID of the deployment. This allows us to automatically update
    * the deployment when the model of the REST API changes.
    */

packages/aws-cdk-lib/aws-apigateway/lib/requestvalidator.ts

@@ -46,7 +46,7 @@ export interface RequestValidatorProps extends RequestValidatorOptions {
    * The rest API that this model is part of.
    *
    * The reason we need the RestApi object itself and not just the ID is because the model
-   * is being tracked by the top-level RestApi object for the purpose of calculating it's
+   * is being tracked by the top-level RestApi object for the purpose of calculating its
    * hash to determine the ID of the deployment. This allows us to automatically update
    * the deployment when the model of the REST API changes.
    */

packages/aws-cdk-lib/aws-apigateway/lib/resource.ts

@@ -31,7 +31,7 @@ export interface IResource extends IResourceBase, IResourceRef {
    * The rest API that this resource is part of.
    *
    * The reason we need the RestApi object itself and not just the ID is because the model
-   * is being tracked by the top-level RestApi object for the purpose of calculating it's
+   * is being tracked by the top-level RestApi object for the purpose of calculating its
    * hash to determine the ID of the deployment. This allows us to automatically update
    * the deployment when the model of the REST API changes.
    */

packages/aws-cdk-lib/aws-s3/lib/bucket-grants.ts

@@ -39,7 +39,7 @@ export class BucketGrants {
   }
 
   /**
-   * Grant read permissions for this bucket and it's contents to an IAM
+   * Grant read permissions for this bucket and its contents to an IAM
    * principal (Role/Group/User).
    *
    * If encryption is used, permission to use the key to decrypt the contents
@@ -53,7 +53,7 @@ export class BucketGrants {
   }
 
   /**
-   * Grant write permissions for this bucket and it's contents to an IAM
+   * Grant write permissions for this bucket and its contents to an IAM
    * principal (Role/Group/User).
    *
    * If encryption is used, permission to use the key to decrypt the contents
@@ -164,7 +164,7 @@ export class BucketGrants {
   }
 
   /**
-   * Grant read and write permissions for this bucket and it's contents to an IAM
+   * Grant read and write permissions for this bucket and its contents to an IAM
    * principal (Role/Group/User).
    *
    * If encryption is used, permission to use the key to decrypt the contents

packages/aws-cdk-lib/aws-s3/lib/bucket.ts

@@ -186,7 +186,7 @@ export interface IBucket extends IResource, IBucketRef {
   arnForObjects(keyPattern: string): string;
 
   /**
-   * Grant read permissions for this bucket and it's contents to an IAM
+   * Grant read permissions for this bucket and its contents to an IAM
    * principal (Role/Group/User).
    *
    * If encryption is used, permission to use the key to decrypt the contents
@@ -249,7 +249,7 @@ export interface IBucket extends IResource, IBucketRef {
   grantDelete(identity: iam.IGrantable, objectsKeyPattern?: any): iam.Grant;
 
   /**
-   * Grants read/write permissions for this bucket and it's contents to an IAM
+   * Grants read/write permissions for this bucket and its contents to an IAM
    * principal (Role/Group/User).
    *
    * If an encryption key is used, permission to use the key for
@@ -857,7 +857,7 @@ export abstract class BucketBase extends Resource implements IBucket, IEncrypted
   }
 
   /**
-   * Grant read permissions for this bucket and it's contents to an IAM
+   * Grant read permissions for this bucket and its contents to an IAM
    * principal (Role/Group/User).
    *
    * If encryption is used, permission to use the key to decrypt the contents

packages/aws-cdk-lib/core/lib/stack.ts

@@ -775,7 +775,7 @@ export class Stack extends Construct implements ITaggable {
   }
 
   /**
-   * Indicates if this is a nested stack, in which case `parentStack` will include a reference to it's parent.
+   * Indicates if this is a nested stack, in which case `parentStack` will include a reference to its parent.
    */
   public get nested(): boolean {
     return this.nestedStackResource !== undefined;

packages/aws-cdk-lib/cx-api/lib/cxapi.ts

@@ -22,7 +22,7 @@ export const DEFAULT_REGION_ENV = 'CDK_DEFAULT_REGION';
 /**
  * Version of Cloud Assembly expected by CDK Toolkit.
  *
- * Despite it's name, this value applies to all version of the CDK Toolkit, not just the CLI.
+ * Despite its name, this value applies to all version of the CDK Toolkit, not just the CLI.
  *
  * CLI started emitting this at 1.10.1
  */