Merge pull request #940 from ArmDeveloperEcosystem/main

production update

.wordlist.txt

@@ -2700,4 +2700,8 @@ lp
 abetlen
 ee
 pkgx
-mprof
+mprof
+rustc
+binutils
+RPi
+GoogleTest

content/install-guides/anaconda.md

@@ -30,7 +30,7 @@ The `conda` command can be used to quickly install and use Python packages.
 
 Follow the instructions below to install and use Anaconda Distribution on an Arm server.
 
-## Before you begin
+## What should I do before installing Anaconda?
 
 Confirm you are using an Arm machine by running:
 
@@ -48,29 +48,29 @@ If you see a different result, you are not using an Arm computer running 64-bit
 
 The installer requires some desktop related libraries. The dependencies can be met by installing a desktop environment. 
 
-For Ubuntu/Debian run the command:
+For Ubuntu/Debian, run the command:
 
 ```console
 sudo apt install xfce4 -y
 ```
 
-For Amazon Linux run the command:
+For Amazon Linux, run the command:
 
 ```console
 sudo amazon-linux-extras install mate-desktop1.x
 ```
 
-## Download 
+## How do I download the latest Anaconda distribution? 
 
-Download the latest Anaconda Distribution.
+To download the latest Anaconda distribution, run:
 
 ```bash
 curl -O https://repo.anaconda.com/archive/Anaconda3-2023.09-0-Linux-aarch64.sh
 ```
 
 Depending on the version, the downloaded filename will be of the form `Anaconda3-20XX.YY-Linux-x86_64.sh` where the `XX` and `YY` values represent the year and month of the latest release.
 
-## Install
+## What are the steps to install the downloaded Anaconda distribution?
 
 Run the downloaded install script.
 
@@ -82,17 +82,17 @@ If you wish to review the license terms before accepting, remove `-b`.
 sh ./Anaconda3-2023.09-0-Linux-aarch64.sh -b
 ```
 
-The install will take a couple of minutes to complete.
+The install takes a couple of minutes to complete.
 
-The batch installation will not setup the shell. 
+The batch installation will not set up the shell. 
 
-To setup the shell run.
+To set up the shell, run:
 
 ```bash
 eval "$($HOME/anaconda3/bin/conda shell.bash hook)"
 ```
 
-## Get started
+## How do I get started with Anaconda after installation?
 
 Test Anaconda Distribution by running simple TensorFlow and PyTorch examples.
 

content/install-guides/ansible.md

@@ -23,7 +23,7 @@ Ansible command-line tools can be installed on a variety of Linux distributions.
 
 [General installation information](https://docs.ansible.com/ansible/latest/installation_guide/installation_distros.html) is available which covers all supported operating systems, but it doesn't talk about Arm-based hosts.
 
-## Before you begin
+## What should I do before I start installing the Ansible command line tools?
 
 This article provides a quick solution to install the Ansible command line tools, such as `ansible-playbook` for Ubuntu on Arm.
 
@@ -41,11 +41,11 @@ aarch64
 
 If you see a different result, you are not using an Arm-based machine running 64-bit Linux.
 
-## Download and Install
+## How do I download and install Ansible for Ubuntu on Arm? 
 
-The easiest way to install the latest version of Ansible for Ubuntu on Arm is to use the PPA (personal package archive).
+The easiest way to install the latest version of Ansible for Ubuntu on Arm is to use the PPA (Personal Package Archive).
 
-To enable the PPA and install Ansible run the commands:
+To enable the PPA and install Ansible, run the commands:
 
 ```bash
 sudo apt update

content/install-guides/aws-cli.md

@@ -25,7 +25,7 @@ weight: 1
 
 It is available for a variety of operating systems and Linux distributions, supports the Arm architecture and has multiple ways to install it. 
 
-## Before you begin
+## What should I do before installing AWS CLI?
 
 This article provides quick solutions to install the latest version of AWS CLI, version 2, for Ubuntu on Arm.
 
@@ -43,7 +43,7 @@ aarch64
 
 If you see a different result, you are not using an Arm computer running 64-bit Linux.
 
-## Download and install AWS CLI version 2
+## How do I download and install AWS CLI version 2?
 
 The easiest way to install the latest version of the AWS CLI for Ubuntu on Arm is to download and run the installer from AWS.
 
@@ -70,4 +70,4 @@ aws --version
 
 Review [AWS CLI v2 is now generally available](https://aws.amazon.com/blogs/developer/aws-cli-v2-is-now-generally-available/) to review the new features in version 2. 
 
-You now have the latest version of the AWS CLI installed. Follow [this guide](/install-guides/aws_access_keys/) to generate and configure access keys needed to use the AWS CLI.
+You now have the latest version of the AWS CLI installed. Follow [this guide](/install-guides/aws_access_keys/) to generate and configure access keys needed to use the AWS CLI.

content/install-guides/aws_access_keys.md

@@ -26,11 +26,11 @@ layout: installtoolsall         # DO NOT MODIFY. Always true for tool install ar
 
 In this section you will learn how to generate and configure Access keys. Access keys consist of an access key ID and secret access key, which are used to sign programmatic requests that you make to AWS.
 
-## Before you begin
+## What should I do before generating AWS Access keys?
 
 Install the AWS CLI on your machine using the [install guide](/install-guides/aws-cli/).
 
-## Generate Access keys (access key ID and secret access key)
+## How do I generate AWS Access keys (access key ID and secret access key)?
 
 Go to My Security Credentials
 

content/install-guides/browsers/chromium.md

@@ -23,7 +23,7 @@ multitool_install_part: true    # Set to true if a sub-page of a multi-page arti
 layout: installtoolsall         # DO NOT MODIFY. Always true for tool install articles
 ---
 
-## Installing Chromium
+## How do I install Chromium?
 
 The Chromium browser runs on Windows on Arm as a native ARM64 application, and is available on Arm Linux distributions.
 
@@ -33,7 +33,7 @@ The Chromium browser runs on Windows on Arm as a native ARM64 application, and i
 Google API keys are missing from Chromium so you will not be able to sync information with your Google account.
 {{% /notice %}}
 
-### Linux
+### How do I install Chromium on Arm Linux?
 
 The best way to install Chromium on Arm Linux is to use the package manager for your distribution. 
 
@@ -53,7 +53,7 @@ sudo dnf install chromium -y
 
 Depending on your version of Ubuntu, Chromium may be installed as a snap from the [Canonical Snap Store](https://snapcraft.io/). 
 
-### Windows 
+### How do I install Chromium on Windows on Arm? 
 
 Chromium is available as a native ARM64 application for Windows on Arm. 
 

content/install-guides/cmake.md

@@ -28,15 +28,15 @@ weight: 1
 
 It is available for a variety of operating systems and there are multiple ways to install it. 
 
-## Before you begin
+## What should I do before installing CMake for Arm Linux distributions or CMake for Windows on Arm?
 
 This article provides quick instructions to install CMake for Arm Linux distributions and for Windows on Arm.
 
-### Windows on Arm
+### How do I download and install CMake for Windows on Arm?
 
 Confirm you are using a Windows on Arm device such as Windows Dev Kit 2023 or a laptop such as Lenovo ThinkPad X13s or Surface Pro 9 with 5G.
 
-### Arm Linux
+### How do I download and install CMake for Arm Linux distributions?
 
 Confirm you are using an Arm computer with 64-bit Linux by running:
 
@@ -52,7 +52,7 @@ aarch64
 
 If you see a different result, you are not using an Arm computer running 64-bit Linux.
 
-## Download and install on Windows
+## How do I download and install on Windows on Arm?
 
 Native CMake support for Windows on Arm is available starting with version 3.24. Installers are available now from the [CMake download](https://cmake.org/download/) page. Emulated CMake can be used but is no longer needed unless an older version of CMake must be used.
 
@@ -74,7 +74,7 @@ Wait for the installer to complete and click `Finish`:
 
 ![Install #center](/install-guides/_images/cmake-finish.png)
 
-## Download and install on Linux
+## How do I download and install on Linux?
 
 There are multiple ways to install CMake on Linux. 
 
@@ -126,7 +126,7 @@ bash /home/$USER/cmake-3.28.1-Linux-aarch64.sh --skip-license --exclude-subdir -
 export PATH=$PATH:$HOME/cmake/bin
 ```
 
-### Verify CMake is installed
+### How do I verify that CMake is installed?
 
 1. Confirm CMake is installed on Linux or Windows. 
 

content/install-guides/docker/_index.md

@@ -15,12 +15,17 @@ multitool_install_part: false   # Set to true if a sub-page of a multi-page arti
 layout: installtoolsall         # DO NOT MODIFY. Always true for tool install articles
 ---
 
-Docker containers are widely used, primarily because they run the same everywhere. Containers are used on all operating systems, on all computing architectures to build, share, and run software.
+## Why use Docker?
 
-The operating system of the computer and the architecture (x86 or Arm) will determine how to install Docker.
+Docker containers are widely used, primarily because they run the same everywhere. Containers are used on all operating systems, on all computing architectures, to build, share, and run software.
 
-- Docker Engine on Linux runs on a variety of Linux distributions and architectures, including arm32v7 and arm64v8 (aarch64). Use these instructions for Linux and Chrome OS (using the Linux feature).
+The operating system of the computer and the architecture (x86 or Arm) determines how to install Docker.
+### How do I install Docker on Linux and Chrome OS?
+
+- Docker Engine on Linux runs on a variety of Linux distributions and architectures, including arm32v7 and arm64v8 (AArch64). Use these instructions for Linux and Chrome OS (using the Linux feature).
+
+### How do I install Docker on Windows and macOS?
 
 - Docker Desktop is the easiest way to install Docker on Windows and macOS. The macOS version supports both Intel and Apple Silicon. The Windows version does not support Windows on Arm. There is also a new Docker Desktop for Linux available if your machine has KVM support and is running a KDE or Gnome desktop environment.    
 
-- Docker on Windows on Arm can be run on Windows on Arm machines using the Windows Subsystem for Linux 2 (WSL 2). There is no Docker Desktop for Windows on Arm, [please show your support by asking for it](https://github.com/docker/roadmap/issues/91).
+- Docker on Windows on Arm runs on Windows on Arm machines using the Windows Subsystem for Linux 2 (WSL 2). There is no Docker Desktop for Windows on Arm, [please show your support by asking for it](https://github.com/docker/roadmap/issues/91).

content/install-guides/docker/docker-desktop.md

@@ -22,7 +22,7 @@ multi_install: false            # Set to true if first page of multi-page articl
 multitool_install_part: true    # Set to true if a sub-page of a multi-page article, else false
 layout: installtoolsall         # DO NOT MODIFY. Always true for tool install articles
 ---
-## Install and test Docker Desktop
+## How do I install and test Docker Desktop?
 
 All of the download files are available on the 
 [Docker Desktop product page](https://www.docker.com/products/docker-desktop/).

content/install-guides/docker/docker-woa.md

@@ -23,26 +23,26 @@ multitool_install_part: true    # Set to true if a sub-page of a multi-page arti
 layout: installtoolsall         # DO NOT MODIFY. Always true for tool install articles
 ---
 
-## Install Docker for Windows on Arm {#docker-woa}
+## How do I install Docker for Windows on Arm {#docker-woa}?
 
 Docker can be run on Windows on Arm machines using the Windows Subsystem for Linux 2 (WSL2).
 
 There is no Docker Desktop for Windows on Arm, [please show your support by asking for it](https://github.com/docker/roadmap/issues/91)
 
-### Before you begin
+### What should I do before installing Docker for Windows on Arm?
 
 - Install WSL 2 on the Windows on Arm laptop
 - Install a Linux distribution such as Ubuntu 22.04 Linux distribution in WSL 2 from the Microsoft Store
 
 More information is available in the Learning Path [Get started with Windows Subsystem for Linux (WSL) on Arm](/learning-paths/laptops-and-desktops/wsl2/).
 
-### Example Windows on Arm computers
+### Which Windows on Arm computers are supported?
+Below are three examples of Windows on Arm computers today:
+- Lenovo Thinkpad X13s.
+- Microsoft Surface Pro X.
+- Samsung Galaxy Book S.
 
-- Lenovo Thinkpad X13s
-- Microsoft Surface Pro X
-- Samsung Galaxy Book S
-
-### Install and test Docker Engine
+### How do I install and test Docker Engine?
 
 You can use the general Linux install instructions to install Docker in WSL 2 for Windows on Arm. 
 

content/install-guides/eksctl.md

@@ -25,7 +25,7 @@ The Amazon EKS CLI, `eksctl`, is a command line tool to create and manage Kubern
 
 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.
 
-## Before you begin
+## What should I do before installing eksctl on Arm Linux and Windows on Arm?
 
 This install guide provides a quick solution to install `eksctl` on Arm Linux and Windows on Arm. 
 
@@ -55,7 +55,7 @@ In the Device specifications section look for "ARM-based processor" in the Syste
 
 Install the Kubernetes command-line tool, `kubectl`, using the [Kubectl install guide](/install-guides/kubectl/).
 
-## Download and install on Linux
+## How do I download and install eksctl on Arm Linux?
 
 1. Download the `eksctl` package using `curl`: 
 
@@ -82,7 +82,7 @@ The output will be similar to:
 0.160.0
 ```
 
-## Download and install on Windows
+## How do I download and install eksctl on Windows?
 
 1. Use a browser to download the [EKS CLI latest release](https://github.com/eksctl-io/eksctl/releases/latest/download/eksctl_Windows_arm64.zip).
 
@@ -100,13 +100,13 @@ The output will be similar to:
 0.160.0
 ```
 
-## Configure the AWS CLI
+## 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. 
 
-## Create a simple EKS cluster
+## How do I use eksctl to create a simple EKS cluster?
 
 With your AWS account configured, run `eksctl` to create a cluster with 2 nodes with AWS Graviton processors: 
 
@@ -135,9 +135,9 @@ 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
 ```
 
-## Delete the cluster
+## How do I use eksctl to delete the cluster?
 
-To delete the resources associated with the cluster run:
+To delete the resources associated with the cluster, run:
 
 ```console
 eksctl delete cluster --region=us-east-1 --name=cluster-1

content/install-guides/gcc/_index.md

@@ -13,23 +13,24 @@ multi_install: true             # Set to true if first page of multi-page articl
 multitool_install_part: false   # Set to true if a sub-page of a multi-page article, else false
 layout: installtoolsall         # DO NOT MODIFY. Always true for tool install articles
 ---
-There are multiple flavors of [GCC, the GNU Compiler Collection](https://gcc.gnu.org/), for the Arm architecture, and for different use cases. TO determine which flavor you need, consider the variables below:
+
+## What should I consider to determine the correct GCC flavor?
+
+There are multiple flavors of [GCC, the GNU Compiler Collection](https://gcc.gnu.org/), for the Arm architecture, and for different use cases. To determine which flavor you need, consider the variables below:
 
 - Target environment where you want the compiled software to run: bare metal or real time operating system (RTOS), Linux kernel and applications, Android applications, or Windows applications.
 
 - Host machine, where you will do the compiling: Windows, Linux, or macOS
 
 - Architecture of the host machine: x86 or Arm
 
-This section provides installation instructions for GCC targeting the Arm architecture.
-
-Navigate to the section of interest.
+This section provides installation instructions for GCC targeting the Arm architecture. Navigate to the section of interest.
 
-- GCC as a native compiler on Arm Linux
+## How do I use GCC as a native compiler on Arm Linux?
 Use this option to install GCC using the Linux package manager and build applications on an Arm Linux system. 
 
-- GCC as a cross-compiler
+## How do I use GCC as a cross-compiler on Arm Linux?
 Use this option to install GCC using the Linux package manager and build bare metal applications by cross compiling them for the Arm architecture from an x86 or Arm Linux host machine. Also, use this option to install and compile Linux applications from an x86 host for an Arm target. 
 
-- GCC from the Arm GNU Toolchain
+## How do I use GCC from the Arm GNU Toolchain?
 Use this option to download an install a version of GCC produced by Arm. It is available from the Arm Developer website and works on Linux, Windows, and macOS host machines. It supports bare-metal and Linux targets. 

content/install-guides/gcloud.md

@@ -24,7 +24,7 @@ The Google Cloud CLI, `gcloud`, allows you to run commands in your Google Cloud
 
 `gcloud` is available for Windows, macOS, Linux and supports the Arm architecture. 
 
-## Before you begin
+## What should I consider before installing gcloud?
 
 Use the documentation link to find alternative installation options. 
 
@@ -44,7 +44,7 @@ aarch64
 
 If you see a different result, you are not using an Arm computer running 64-bit Linux.
 
-## Download and Install
+## How do I download and install for Ubuntu on Arm?
 
 The easiest way to install `gcloud` for Ubuntu on Arm is to use the package manager.
 
@@ -81,7 +81,7 @@ gcloud-crc32c 1.0.0
 gsutil 5.20
 ```
 
-## Acquire user credentials
+## How do I acquire user access credentials for Google Cloud? {#acquire-user-credentials}
 
 You can use `gcloud` to obtain user access credentials for Google Cloud using a web flow. You will put the credentials in a well-known location for Application Default Credentials (`ADC`).