Merge pull request #1887 from jasonrandrews/review2

Change install guide headings to questions

Author: jasonrandrews

content/install-guides/acfl.md

@@ -26,7 +26,7 @@ Arm Compiler for Linux runs on 64-bit Arm machines, it is not a cross-compiler.
 
 You do not require any additional license to use Arm Compiler for Linux.
 
-## Arm-based hardware
+## What Arm-based hardware is supported by Arm Compiler for Linux (ACfL)?
 
 Arm Compiler for Linux supports all 64-bit Arm based [server-class hardware](/learning-paths/servers-and-cloud-computing/intro/).
 
@@ -46,7 +46,7 @@ aarch64
 
 If you see a different result, you are not using an Arm computer running 64-bit Linux.
 
-## Install pre-requisites
+## What pre-requisites do I need to install for ACfL?
 
 If any of the following tools are not already installed by your Linux
 distribution, you must install them before installing Arm Compiler for Linux.
@@ -72,25 +72,25 @@ sudo apt install -y python-is-python3 libc6-dev
 
 You are now ready to install ACfL [manually](#manual) or with [Spack](#spack).
 
-## Download and install using install script
+## How do I download and install ACfL using the install script?
 
 Use an Arm recommended script to select, download, and install your preferred ACfL package.
 
 ```console
 bash <(curl -L https://developer.arm.com/-/cdn-downloads/permalink/Arm-Compiler-for-Linux/Package/install.sh)
 ```
 
-## Download and install manually {#manual}
+## How do I download and install ACfL manually? {#manual}
 
-### Download with wget
+### How do I download ACfL with wget?
 
 Download releases from the command line using `wget`. Install `wget` if not present.
 
 ```bash
 sudo apt install wget
 ```
 
-### Fetch the appropriate installer
+### How do I fetch the appropriate ACfL installer?
 
 ACfL installation packages are available to download from [Arm Developer](https://developer.arm.com/downloads/-/arm-compiler-for-linux). Individual Arm Performance Libraries (ArmPL) packages are also available.
 
@@ -106,7 +106,7 @@ wget  https://developer.arm.com/-/cdn-downloads/permalink/Arm-Compiler-for-Linux
 wget https://developer.arm.com/-/cdn-downloads/permalink/Arm-Compiler-for-Linux/Version_24.10.1/arm-compiler-for-linux_24.10.1_RHEL-9_aarch64.tar
 ```
 
-### Install
+### How do I install ACfL?
 
 To install Arm Compiler for Linux on your 64-bit Linux Arm machine extract the package and run the installation script.
 
@@ -139,13 +139,13 @@ install takes place **after** ACfL, you will no longer be able to fully
 uninstall ACfL.
 {{% /notice %}}
 
-## Download and install using System Packages
+## How do I download and install ACfL using System Packages?
 
-### Ubuntu Linux 20.04 and 22.04
+### How do I install ACfL on Ubuntu Linux 20.04 and 22.04?
 
 Arm Compiler for Linux is available to install with the Ubuntu system package manager `apt` command.
 
-#### Set up the ACfL package repository
+#### How do I set up the ACfL package repository?
 
 Add the ACfL `apt` package repository to your system. These instructions apply for Ubuntu 22.04. You can check the [available versions](https://developer.arm.com/packages/) for other releases.
 
@@ -166,11 +166,11 @@ Install Arm Compiler for Linux with:
 sudo apt install acfl -y
 ```
 
-### Amazon Linux 2023
+### How do I install ACfL on Amazon Linux 2023?
 
 Arm Compiler for Linux is available to install with either the `dnf` or `yum` system package manager.
 
-#### Install ACfL from the Amazon Linux 2023 package repository
+#### How do I install ACfL from the Amazon Linux 2023 package repository?
 
 Install ACfL and prerequisites from the Amazon Linux 2023 `rpm` package repository with `dnf`:
 
@@ -192,11 +192,11 @@ sudo yum -y install acfl
 
 The ACfL tools are now ready to use.
 
-### Red Hat Enterprise Linux (RHEL) 9
+### How do I install ACfL on Red Hat Enterprise Linux (RHEL) 9?
 
 Arm Compiler for Linux is available to install with either the `dnf` or `yum` system package manager.
 
-#### Install ACfL from the RHEL 9 package repository
+#### How do I install ACfL from the RHEL 9 package repository?
 
 Install ACfL and prerequisites from the RHEL 9 `rpm` package repository with `dnf`:
 
@@ -218,7 +218,7 @@ sudo yum -y install acfl
 
 The ACfL tools are now ready to use.
 
-### Set up environment
+### How do I set up the environment for ACfL?
 
 Arm Compiler for Linux uses environment modules to dynamically modify your user environment. Refer to the [Environment Modules documentation](https://lmod.readthedocs.io/en/latest/#id) for more information.
 
@@ -256,13 +256,13 @@ module load gnu/14.2.0
 
 ACfL is now [ready to use](#armclang).
 
-## Download and install with Spack {#spack}
+## How do I download and install ACfL with Spack? {#spack}
 
 Arm Compiler for Linux is available with the [Spack](https://spack.io/) package manager.
 
 See the [Arm Compiler for Linux and Arm PL now available in Spack](https://community.arm.com/arm-community-blogs/b/high-performance-computing-blog/posts/arm-compiler-for-linux-and-arm-pl-now-available-in-spack) blog for full details.
 
-### Set up Spack
+### How do I set up Spack for ACfL?
 
 Clone the Spack repository and add `bin` directory to the path:
 
@@ -279,7 +279,7 @@ Set up shell support:
 
 Spack is now ready to use.
 
-### Install ACfL
+### How do I install ACfL using Spack?
 
 Download and install Arm Compiler for Linux with:
 
@@ -293,7 +293,7 @@ If you wish to install just the Arm Performance Libraries, use:
 spack install armpl-gcc
 ```
 
-### Set up environment
+### How do I set up the environment for ACfL using Spack?
 Use the commands below to set up the environment:
 
 ```console
@@ -304,7 +304,7 @@ spack compiler find
 ACfL is now [ready to use](#armclang).
 
 
-## Get started with Arm C/C++ compiler {#armclang}
+## How do I get started with the Arm C/C++ compiler? {#armclang}
 
 To get started with the Arm C/C++ Compiler and compile a simple application follow the steps below.
 
@@ -342,7 +342,7 @@ The program will output the string specified.
 Hello, C World!
 ```
 
-## Get started with Arm Fortran compiler {#fortran}
+## How do I get started with the Arm Fortran compiler? {#fortran}
 
 To get started with the Arm Fortran Compiler and compile a simple application follow the steps below.
 
@@ -375,6 +375,6 @@ The program will output the string specified.
 Hello, Fortran World!
 ```
 
-## Get started with Arm Performance Libraries {#armpl}
+## How do I get started with Arm Performance Libraries? {#armpl}
 
 To get started with the [Arm Performance Libraries](https://developer.arm.com/Tools%20and%20Software/Arm%20Performance%20Libraries) and learn how to select the optimal library for your system, follow the [Get started with Arm Performance Libraries](https://developer.arm.com/documentation/101004/latest) guide.

content/install-guides/ambaviz.md

@@ -37,7 +37,7 @@ test_images:
 
 A detailed overview of functionality is described in [Introduction to AMBA Viz](https://community.arm.com/arm-community-blogs/b/soc-design-and-simulation-blog/posts/introduction-to-amba-viz).
 
-## Download installer packages
+## How do I download AMBA Viz?
 
 AMBA Viz is a component of [Arm Hardware Success Kits](https://www.arm.com/products/development-tools/success-kits).
 
@@ -47,7 +47,7 @@ You can download AMBA Viz as an individual component, or you can download comple
 
 For more information on the Download Hub, refer to the [Arm Product Download Hub install guide](/install-guides/pdh/).
 
-## Installation
+## How do I install AMBA Viz?
 
 AMBA Viz requires a Linux host machine with Java 11 or JavaFX.
 
@@ -73,13 +73,13 @@ The AMBA Viz Release Notes provide full installation instructions, located in th
 docs/public/assets/pdfs/ambaviz-release-note.pdf
 ```
 
-## Set up the product license
+## How do I set up the AMBA Viz product license?
 
 AMBA Viz is license-managed. A Hardware Success Kit license is necessary.
 
 License set up instructions are available in the [Arm License install guide](/install-guides/license/).
 
-## Get started
+## How do I get started with AMBA Viz?
 
 Typically, AMBA Viz is launched with a waveform file:
 ```console

content/install-guides/ams.md

@@ -47,26 +47,26 @@ It comprises of a suite of easy-to-use tools that show you how well your game or
 
 All features of Arm Performance Studio are available free of charge without any additional license as of the `2022.4` release.
 
-## Installation
+## How do I install Arm Performance Studio?
 
 Arm Performance Studio is supported on Windows, Linux, and macOS hosts. Download the appropriate installer from [Arm Performance Studio Downloads](https://developer.arm.com/Tools%20and%20Software/Arm%20Performance%20Studio#Downloads).
 
 Full installation and application launch instructions are given in the Arm Performance Studio [Release Notes](https://developer.arm.com/documentation/107649).
 
-### Windows
+### How do I install Arm Performance Studio on Windows?
 
 Run the supplied `Arm_Performance_Studio_<version>_windows_x86-64.exe` installer, and follow on-screen instructions.
 
-### Linux
+### How do I install Arm Performance Studio on Linux?
 
 Unpack the supplied `Arm Performance Studio` bundle to the desired location. For example:
 ```console
 tar -xf Arm_Performance_Studio_2024.3_linux_x86-64.tgz
 ```
-### macOS
+### How do I install Arm Performance Studio on macOS?
 
 Run the supplied `Arm_Performance_Studio_<version>_macos_x86-64.dmg` installer, and follow on-screen instructions.
 
-## Get started
+## How do I get started with Arm Performance Studio?
 
 See the [Get started with Arm Performance Studio for Mobile](/learning-paths/mobile-graphics-and-gaming/ams/) learning path for a collection of tutorials for each component of Performance Studio.

content/install-guides/anaconda.md

@@ -95,7 +95,7 @@ eval "$($HOME/anaconda3/bin/conda shell.bash hook)"
 
 Test Anaconda Distribution by running simple TensorFlow and PyTorch examples.
 
-### TensorFlow
+### How do I use TensorFlow with Anaconda?
 
 Create a new conda environment named tf, install TensorFlow, and activate the new environment.
 
@@ -139,7 +139,7 @@ The expected output format is below. Your version may be slightly different.
 tf.Tensor(342.34387, shape=(), dtype=float32)
 ```
 
-### PyTorch
+### How do I use PyTorch with Anaconda?
 
 Create a new conda environment named torch, install PyTorch, and activate the new environment.
 

content/install-guides/ansible.md

@@ -61,15 +61,15 @@ sudo add-apt-repository --yes --update ppa:ansible/ansible
 sudo apt install ansible -y
 ```
 
-## Install Ansible for macOS
+## How do I install Ansible for macOS?
 
 You can use the `brew` package manager to install on `arm64`:
 
 ```console
 brew install ansible
 ```
 
-## Confirm installation
+## How do I confirm the installation?
 
 Confirm the Ansible command line tools are installed by running:
 

content/install-guides/aperf.md

@@ -19,7 +19,7 @@ APerf was created by AWS to help with Linux performance analysis.
 
 In addition to the CLI, APerf includes an HTML view to visualize the collected data.
 
-## Before you begin
+## What should I do before I begin installing APerf?
 
 APerf works on Linux, and is available as a single binary.
 
@@ -41,7 +41,7 @@ aarch64
 
 If you see a different result, you are not using an Arm computer running 64-bit Linux.
 
-## Download and install APerf
+## How do I download and install APerf?
 
 The easiest way to install APerf is to download a release from GitHub, extract it, and setup your `PATH` environment variable or copy the executable to a directory already in your search path.
 
@@ -84,9 +84,9 @@ The output should print the version:
 aperf 0.1.0 (4b910d2)
 ```
 
-## Verify APerf is working
+## How do I verify APerf is working?
 
-### Create and view a report
+### How do I create and view a report?
 
 To confirm APerf is working, start it for 10 seconds and take a sample every 1 second.
 
@@ -120,7 +120,7 @@ You can browse the data and see what has been collected.
 The Kernel Config and Sysctl Data tabs are blank unless you click No.
 {{% /notice %}}
 
-### Create and view a report containing 2 runs
+### How do I create and view a report containing 2 runs?
 
 To demonstrate comparing 2 runs, create a second run with `aperf record`:
 
@@ -144,7 +144,7 @@ A screenshot is shown below:
 
 ![APerf #center](/install-guides/_images/aperf.png)
 
-### Use an HTTP server
+### How do I use an HTTP server to view reports?
 
 If you are doing performance analysis on a remote system or cloud instance without a remote desktop, you can view the APerf reports from your local browser by running a simple web server on the remote machine.
 

content/install-guides/arduino-pico.md

@@ -24,13 +24,13 @@ You can install the Arduino IDE and Arduino core software for the Raspberry Pi P
 
 Arduino core is the software stack that powers Arduino devices and development boards. While the Raspberry Pi Pico isn't an Arduino board, it uses the same RP2040 SoC as the Arduino RP2040 Connect, and therefore can run the same Arduino core software.
 
-## Install Arduino IDE
+## How do I install Arduino IDE?
 
 First, you need to install the Arduino IDE on your laptop or desktop. You can download it for your operating system from [the Arduino Software website](https://www.arduino.cc/en/software). Follow the provided instructions for installing the IDE.
 
 Start the IDE by clicking the Arduino IDE icon.
 
-## Install board support package
+## How do I install the board support package?
 
 The Arduino software is comprised of the core libraries and a Board Support Package that is specific to your device. You need to install the `Arduino Mbed OS RP2040 Boards` package to support the Raspberry Pi Pico.
 
@@ -42,7 +42,7 @@ When the `Boards Manager` opens search for `pico` and the `Arduino Mbed OS RP204
 
 ![Arduino Board Manager](/install-guides/_images/arduino_rp2040_boards.png)
 
-### Raspberry Pi Pico W
+### How do I set up the Raspberry Pi Pico W?
 
 The `Boards Manager` package for for `Arduino Mbed OS RP2040 Boards` does not include the Raspberry Pi Pico W.
 
@@ -54,13 +54,13 @@ https://github.com/earlephilhower/arduino-pico/releases/download/global/package_
 
 Return to `Tools -> Board -> Boards Manager` and search for `pico` and you will see a new entry `Raspberry Pi Pico/RP2040`. Click the `Install` button to add it to the Arduino IDE.
 
-## Select your board
+## How do I select my board?
 
 Once the support package is installed, you need to tell the Arduino IDE which supported board you will be using. From the `Tools -> Board` menu, find and select `Raspberry Pi Pico` or `Raspberry Pi Pico W` depending on your board type.
 
 ![Arduino Board Selection](/install-guides/_images/arduino_rp2040_select.png)
 
-## Upload to your board
+## How do I upload code to my board?
 
 Because the Raspberry Pi Pico doesn't come with the Arduino core software installed, the Arduino IDE won't recognize it.