Merge branch 'ArmDeveloperEcosystem:main' into BmanClark/main

Author: annietllnd

content/install-guides/eksctl.md

@@ -9,25 +9,26 @@ layout: installtoolsall
 minutes_to_complete: 5
 multi_install: false
 multitool_install_part: false
-official_docs: https://docs.aws.amazon.com/eks/latest/userguide/eksctl.html
+official_docs: https://docs.aws.amazon.com/eks/latest/eksctl/what-is-eksctl.html
+description: Install eksctl (Amazon EKS CLI) on Arm Linux and Windows on Arm to create and manage Kubernetes clusters on Amazon EKS.
 test_images:
 - ubuntu:latest
 test_link: null
 test_maintenance: true
-title: AWS EKS CLI (eksctl)
+title: eksctl (Amazon EKS CLI)
 tool_install: true
 weight: 1
 ---
 
-The Amazon EKS CLI, `eksctl`, is a command line tool to create and manage Kubernetes clusters in Amazon Kubernetes Service (EKS). It simplifies cluster creation and saves time compared to using the AWS console. For additional information refer to the [EKS CLI official documentation](https://eksctl.io/).
+`eksctl` is a command line tool to create and manage Kubernetes clusters in [Amazon Elastic Kubernetes Service (Amazon EKS)](https://docs.aws.amazon.com/eks/latest/userguide/what-is-eks.html). It simplifies cluster creation and saves time compared to using the Amazon Web Services (AWS) console. For additional information, see [eksctl official documentation](https://docs.aws.amazon.com/eks/latest/eksctl/what-is-eksctl.html).
 
-The EKS CLI is available for a variety of operating systems and Linux distributions and there are multiple ways to install it. It runs on both Arm Linux distributions and Windows on Arm.
+`eksctl` is available for a variety of operating systems and Linux distributions. It runs on both Arm Linux distributions and Windows on Arm. The following steps show how you can install `eksctl` and verify the installation by creating a simple Amazon EKS cluster.
 
-## What should I do before installing eksctl on Arm Linux and Windows on Arm?
+## Before you begin
 
-This install guide provides a quick solution to install `eksctl` on Arm Linux and Windows on Arm.
+Before installing `eksctl`, follow these steps:
 
-1. Confirm you have an Arm machine
+### Confirm you have an Arm machine
 
 For Linux, confirm you are using an Arm machine by running:
 
@@ -43,25 +44,39 @@ aarch64
 
 If you see a different result, you are not using an Arm computer running 64-bit Linux.
 
-For Windows, confirm the Arm architecture by typing "Settings" in the Windows search box.
+For Windows, follow these steps:
 
-When the settings appear, click System on the left side and then About at the bottom.
+1. Right-click **Start** and choose **Windows Settings**.​​​​​​
+2. When the settings appear, select **System** on the left side and then select **About**.
+3. Under **Device specifications**, look for **System type**. You should see **ARM-based processor** listed for your computer.
 
-In the Device specifications section look for "ARM-based processor" in the System type area.
+If you see a different result, you are not using an Arm computer running Windows.
 
-2. Install `kubectl`
+### Install kubectl
 
-Install the Kubernetes command-line tool, `kubectl`, using the [Kubectl install guide](/install-guides/kubectl/).
+Install the Kubernetes command-line tool `kubectl` by following the steps in the [Kubectl install guide](/install-guides/kubectl/).
 
-## How do I download and install eksctl on Arm Linux?
+### Configure the AWS CLI
+
+`eksctl` relies on the AWS CLI being installed and configured. Use the [AWS CLI install guide](/install-guides/aws-cli/) to install the AWS CLI. The CLI provides the `aws` command.
+
+You'll also need to configure the AWS CLI using the `aws configure` or the `aws configure sso` command. There are multiple ways to configure the CLI, including environment variables, command-line options, and credentials files. Refer to [Configuring settings for the AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) for more details.
+
+## Download and install eksctl 
+
+The steps for downloading and installing `eksctl` depend on your operating system.
+
+### Arm Linux
+
+To download and install `eksctl` on Arm Linux, follow these steps:
 
 1. Download the `eksctl` package using `curl`:
 
 ```bash { target="ubuntu:latest" }
 curl -sLO "https://github.com/eksctl-io/eksctl/releases/latest/download/eksctl_Linux_arm64.tar.gz"
 ```
 
-2. Install `eksctl` with:
+2. Install `eksctl`:
 
 ```bash { target="ubuntu:latest" }
 tar -xzf eksctl_Linux_arm64.tar.gz -C /tmp && rm eksctl_Linux_arm64.tar.gz
@@ -74,13 +89,15 @@ sudo mv /tmp/eksctl /usr/local/bin
 eksctl version
 ```
 
-The output will be similar to:
+The output is similar to:
 
 ```output
 0.160.0
 ```
 
-## How do I download and install eksctl on Windows?
+### Windows on Arm
+
+To download and install `eksctl` on Windows, follow these steps:
 
 1. Use a browser to download the [EKS CLI latest release](https://github.com/eksctl-io/eksctl/releases/latest/download/eksctl_Windows_arm64.zip).
 
@@ -92,21 +109,15 @@ The output will be similar to:
 eksctl.exe version
 ```
 
-The output will be similar to:
+The output is similar to:
 
 ```output
 0.160.0
 ```
 
-## How do I configure the AWS CLI?
-
-`eksctl` relies on the AWS CLI being installed and configured. Use the [AWS CLI install guide](/install-guides/aws-cli/) to install the AWS CLI. The CLI provides the `aws` command.
-
-You will also need to configure the AWS CLI using the `aws configure` or the `aws configure sso` command. There are multiple ways to configure the CLI, including environment variables, command-line options, and credentials files. Refer to the [Configure the AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) for more details.
-
-## How do I use eksctl to create a simple EKS cluster?
+## Verify eksctl installation by creating a simple EKS cluster
 
-With your AWS account configured, run `eksctl` to create a cluster with 2 nodes with AWS Graviton processors:
+With your AWS account configured, run `eksctl` to create a cluster with two nodes with AWS Graviton processors:
 
 ```console
 eksctl create cluster  \
@@ -117,7 +128,7 @@ eksctl create cluster  \
 --nodegroup-name node-group-1
 ```
 
-Use the AWS console to look at the resources associated with the cluster and monitor progress of cluster creation.
+Use the AWS console to look at the resources associated with the cluster and monitor the progress of cluster creation.
 
 When the cluster is created, use `kubectl` to get the status of the nodes in the cluster.
 
@@ -133,7 +144,7 @@ ip-192-168-38-144.ec2.internal   Ready    <none>   2m31s   v1.25.13-eks-43840fb
 ip-192-168-4-142.ec2.internal    Ready    <none>   2m31s   v1.25.13-eks-43840fb   192.168.4.142    54.175.254.219   Amazon Linux 2   5.10.192-183.736.amzn2.aarch64   containerd://1.6.19
 ```
 
-## How do I use eksctl to delete the cluster?
+## Use eksctl to delete the cluster
 
 To delete the resources associated with the cluster, run: