Merge pull request #3421 from anupras-mohapatra-arm/aws-cdk

CDK LP and install guide editorial review

Author: jasonrandrews

content/install-guides/aws-cdk.md

@@ -11,22 +11,21 @@ official_docs: https://docs.aws.amazon.com/cdk/v2/guide/home.html
 test_images:
 - ubuntu:latest
 test_maintenance: true
-draft: true
 title: AWS CDK CLI
 description: Install the AWS CDK CLI on Arm Linux and macOS using npm, then verify the setup with the `cdk` command.
 tool_install: true
 weight: 1
 ---
 
-The AWS Cloud Development Kit (CDK) is an open-source infrastructure as code (IaC) software development framework. You can use the AWS CDK to define and deploy applications on Arm-based cloud infrastructure powered by AWS Graviton. 
+The AWS Cloud Development Kit (AWS CDK) is an open-source infrastructure as code (IaC) software development framework. You can use the AWS CDK to define and deploy applications on Arm-based cloud infrastructure powered by AWS Graviton. 
 
-With the CDK, you can write applications in a supported programming language of your choice. You can then use the AWS CDK CLI to translate the code into an AWS CloudFormation template and deploy the application. 
+You can write applications in a supported programming language of your choice. Then, you can use the AWS CDK CLI to translate the code into an AWS CloudFormation template and deploy the application. 
 
 In this guide, you'll learn how to install the CDK CLI and verify that the CLI installation was successful. 
 
 ## Before you begin
 
-Make sure that you have the AWS CLI installed:
+Verify that you have the AWS CLI installed:
 
 ```bash
 aws --version
@@ -37,7 +36,7 @@ The output is similar to:
 ```output
 aws-cli/2.34.56 Python/3.14.5 Darwin/25.5.0 exe/arm64
 ```
-For more information about setting up AWS credentials and installing the AWS CLI, see the [AWS Credentials](/install-guides/aws_access_keys/) and [AWS CLI](/install-guides/aws-cli/) install guides. 
+For instructions to set up AWS credentials and install the AWS CLI, see the [AWS Credentials](/install-guides/aws_access_keys/) and [AWS CLI](/install-guides/aws-cli/) install guides. 
 
 Make sure you have Node.js 22 or later installed:
 
@@ -52,7 +51,7 @@ v26.2.0
 ```
 If you don't have Node.js installed, or if the installed version is earlier than Node.js 22, download a suitable version from the [Node.js website](https://nodejs.org/en/download).
 
-You'll also need to install prerequisites specific to the programming languages that you want to use. For more information about language-specific prerequisites, see [Install Node.js and programming language prerequisites](https://docs.aws.amazon.com/cdk/v2/guide/prerequisites.html#prerequisites-node) in the AWS CDK documentation.
+You'll also need to install prerequisites specific to the programming languages that you want to use. For more information, see [Install Node.js and programming language prerequisites](https://docs.aws.amazon.com/cdk/v2/guide/prerequisites.html#prerequisites-node) in the AWS CDK documentation.
 
 ## Install the AWS CDK CLI
 
@@ -79,4 +78,4 @@ The output is similar to:
 
 You've now installed the AWS CDK CLI and verified that the installation was successful.
 
-Next, you can use the AWS CDK to create and deploy applications on Arm-based compute powered by AWS Graviton. To learn how you can use the CDK and Amazon Elastic Container Service (ECS) to run containers on Arm-based compute, see [Deploy containers on Arm-based compute using Amazon ECS and the AWS CDK](/learning-paths/servers-and-cloud-computing/aws-cdk/).
+Next, you can use the AWS CDK to create and deploy applications on Arm-based compute powered by AWS Graviton. To learn how you can use the AWS CDK and Amazon Elastic Container Service (Amazon ECS) to run containers on Arm-based compute, see [Deploy containers on Arm-based compute using Amazon ECS and the AWS CDK](/learning-paths/servers-and-cloud-computing/aws-cdk/).

content/learning-paths/servers-and-cloud-computing/aws-cdk/_index.md

@@ -2,22 +2,18 @@
 title: Deploy containers on Arm-based compute using Amazon ECS and the AWS CDK
 description: Learn how to define and deploy a containerized application on Arm-based compute using the AWS Cloud Development Kit.
 
-draft: true
-cascade:
-    draft: true
-
 minutes_to_complete: 45
 
-who_is_this_for: This is an introductory topic for software developers who want to use the AWS Cloud Development Kit (AWS CDK) to deploy applications on Arm-based AWS infrastructure.
+who_is_this_for: This is an introductory topic for software developers who want to use the AWS Cloud Development Kit (AWS CDK) to deploy containerized applications on Arm-based AWS infrastructure.
 
 learning_objectives:
     - Create an example AWS CDK application in JavaScript
     - Define AWS infrastructure using the AWS CDK
     - Deploy application resources on Arm-based AWS compute using Amazon ECS and the AWS CDK
 
 prerequisites:
-    - An Amazon Web Services (AWS) account
-    - A local computer with the AWS CLI, AWS CDK CLI, and Node.js installed
+    - An Amazon Web Services (AWS) account 
+    - A local computer with the AWS CLI, AWS CDK CLI, and Node.js installed, with AWS credentials configured.
     - Familiarity with the Linux command line and JavaScript
 
 author: Anupras Mohapatra
@@ -51,6 +47,10 @@ further_reading:
         title: AWS CLI install guide
         link: /install-guides/aws-cli/
         type: install-guide
+    - resource:
+        title: Amazon ECS task definitions for 64-bit Arm workloads
+        link: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-arm64.html
+        type: documentation
 
 ### FIXED, DO NOT MODIFY
 # ================================================================================

content/learning-paths/servers-and-cloud-computing/aws-cdk/app.md

@@ -8,7 +8,7 @@ layout: "learningpathall"
 
 ## Set up a sample AWS CDK application
 
-The AWS Cloud Development Kit (CDK) is an open-source infrastructure as code (IaC) software development framework. 
+The AWS Cloud Development Kit (AWS CDK) is an open-source infrastructure as code (IaC) software development framework. 
 
 In this section, you'll create a JavaScript CDK application that defines an Amazon Elastic Container Service (ECS) service running on Arm-based AWS Fargate compute.
 
@@ -82,7 +82,7 @@ In the project, you'll find a file called `arm-cdk-app-stack.js` in the `lib` di
 
 Update `lib/arm-cdk-app-stack.js` to define a load-balanced Amazon ECS service that runs an NGINX web server on an Arm-based AWS Fargate runtime platform.
 
-Replace the contents of the file with the code below:
+Replace the contents of the file with the following code:
 
 ```javascript
 const cdk = require('aws-cdk-lib');
@@ -112,6 +112,6 @@ module.exports = { ArmCdkAppStack };
 
 ## What you've accomplished and what's next
 
-You've now set up a sample application using AWS CDK.
+You've now set up a sample JavaScript application using AWS CDK and defined an Amazon ECS service that runs on Arm-based AWS Fargate compute.
 
 Next, you'll use AWS CDK to synthesize and deploy the application.

content/learning-paths/servers-and-cloud-computing/aws-cdk/cdk.md

@@ -38,17 +38,17 @@ cdk deploy
 ```
 By default, the AWS CDK CLI will prompt you to approve IAM-related changes during deployment. 
 
-For the AWS CDK CLI to deploy the application without the need for approval, set the `--require-approval` flag to `never` during deployment:
+If you want the AWS CDK CLI to deploy the application without the need for approval, set the `--require-approval` flag to `never` during deployment:
 
 ```bash
 cdk deploy --require-approval never
 ```
 
 {{% notice Note %}}
-The deployment can take a couple minutes to complete.
+The deployment can take a few minutes to complete.
 {{% /notice %}}
 
-When the deployment completes, the last couple lines of the output will include a URL to the web server and the load balancer's DNS name:
+When the deployment completes, the final lines of the output will include a URL to the web server and the load balancer's DNS name:
 
 ```output
 Outputs:
@@ -73,7 +73,7 @@ cdk destroy
 ```
 By default, the AWS CDK CLI will prompt you to approve the deletion of `ArmCDKAppStack`.
 
-For the AWS CDK CLI to clean up resources without the need for approval, use the `--force` or `-f` flag:
+If you want the AWS CDK CLI to clean up resources without the need for approval, use the `--force` or `-f` flag:
 
 ```bash
 cdk destroy -f