Change install guide headings to questions

jasonrandrews · jasonrandrews · commit d4fbfa1f5247 · 2025-04-26T10:39:21.000-05:00
diff --git a/content/install-guides/acfl.md b/content/install-guides/acfl.md
@@ -293,7 +293,7 @@ If you wish to install just the Arm Performance Libraries, use:
 spack install armpl-gcc
 ```
 
-### How do I set up the environment for ACfL with Spack?
+### 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).
 
 
-## How do I get started with the Arm C/C++ compiler in ACfL? {#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.
 
diff --git a/content/install-guides/armclang.md b/content/install-guides/armclang.md
@@ -23,7 +23,7 @@ weight: 1
 
 A safety qualified branch of Arm Compiler for Embedded, known as [Arm Compiler for Embedded FuSa](https://developer.arm.com/Tools%20and%20Software/Arm%20Compiler%20for%20Embedded%20FuSa), is available for safety critical applications.
 
-## How can I access Arm Compiler for Embedded through other tools?
+## How can I access Arm Compiler for Embedded from Arm Development Studio?
 
 The easiest way to access the Arm Compiler for Embedded is to use the version provided with [Arm Development Studio](https://developer.arm.com/Tools%20and%20Software/Arm%20Development%20Studio).
 
@@ -39,7 +39,7 @@ Arm Compiler for Embedded FuSa must also be [downloaded separately](#download).
 
 Individual compiler packages for all supported host platforms can be downloaded from the [Arm Product Download Hub](#pdh) or the [Arm Tools Artifactory](#artifactory).
 
-### How do I download from the Product Download Hub? {#pdh}
+### How do I download Arm Compiler for Embedded from the Product Download Hub? {#pdh}
 
 All compiler packages can be downloaded from the [Arm Product Download Hub](https://developer.arm.com/downloads) (requires login).
 
@@ -87,7 +87,7 @@ set path=(/home/$USER/ArmCompilerforEmbedded6.22/bin $path)
 armclang --version
 ```
 
-### How do I download from the Arm Tools Artifactory? {#artifactory}
+### How do I download Arm Compiler for Embedded from the Arm Tools Artifactory? {#artifactory}
 
 The Arm Compiler for Embedded, as well as other tools and utilities are available in the [Arm Tools Artifactory](https://www.keil.arm.com/artifacts/). The Keil Studio VS Code [Extensions](../keilstudio_vs) use the artifactory to fetch and install and the necessary components.
 
diff --git a/content/install-guides/armpl.md b/content/install-guides/armpl.md
@@ -37,7 +37,7 @@ These libraries are free to use and do not require a license. They can be instal
 
 Arm Performance Libraries are available for use on [Windows 11 on Arm](#windows), [macOS](#macos) (Apple Silicon), and [Linux](#linux) (AArch64) hosts.
 
-## How do I install on Windows? {#windows}
+## How do I install Arm Performance Libraries on Windows? {#windows}
 
 On your Windows 11 Arm machine, go to the [Arm Performance Libraries download page](https://developer.arm.com/downloads/-/arm-performance-libraries).
 Click on the Download Windows section and download the Windows Installer:
@@ -68,7 +68,7 @@ You can now start linking your application to the Arm Performance libraries on y
 For more information refer to [Get started with Arm Performance Libraries](https://developer.arm.com/documentation/109361).
 
 
-## How do I install on macOS? {#macos}
+## How do I install Arm Performance Libraries on macOS? {#macos}
 
 [Download](https://developer.arm.com/downloads/-/arm-performance-libraries) the appropriate package for your macOS distribution.
 
@@ -105,11 +105,11 @@ To get started, compile and test the examples included in the `/opt/arm/<armpl_d
 For more information refer to [Get started with Arm Performance Libraries](https://developer.arm.com/documentation/109362).
 
 
-## How do I install on Linux? {#linux}
+## How do I install Arm Performance Libraries on Linux? {#linux}
 
 Arm Performance Libraries are supported on most Linux distributions like Ubuntu, RHEL, SLES and Amazon Linux on an `AArch64` host and compatible with various versions of GCC, LLVM, and NVHPC. The GCC compatible releases are built with GCC 14 and tested with GCC versions 7 to 14. The LLVM compatible releases are tested with LLVM 19.1. The NVHPC compatible releases are tested with NVHPC 24.7.
 
-### How do I manually download and install on Linux?
+### How do I manually download and install Arm Performance Libraries on Linux?
 
 [Download](https://developer.arm.com/downloads/-/arm-performance-libraries) the appropriate package for your Linux distribution. The deb based installers can be used on Ubuntu 20 and Ubuntu 22. The RPM based installers can be used on the following supported distributions:
 
@@ -141,7 +141,7 @@ Using the `--accept` switch you automatically accept the End User License Agreem
 
 If you want to change the installation directory location use the `--install-to` option with the script and provide the desired directory location.
 
-## How do I download and install using system packages on Linux?
+## How do I download and install Arm Performance Libraries using system packages on Linux?
 
 Arm Performance Libraries are available to install using Linux system package managers. The instructions shown below are for the Ubuntu system package manager `apt` command.
 
@@ -161,7 +161,7 @@ Download and install Arm Performance Libraries with:
 sudo apt install arm-performance-libraries
 ```
 
-### How do I set up the environment on Linux?
+### How do I set up the environment for Arm Performance Libraries on Linux?
 
 Install environment modules on your machine:
 
diff --git a/content/install-guides/avh.md b/content/install-guides/avh.md
@@ -106,7 +106,7 @@ To do this, add the parameter `se.cryptocell.DISABLE_DEVICE=1` to your launch co
 FVP_Corstone-1000 -C se.cryptocell.DISABLE_DEVICE=1  ...
 ```
 
-## How do I use Arm Virtual Hardware 3rd Party? {#thirdparty}
+## How do I use Arm Virtual Hardware 3rd Party targets? {#thirdparty}
 
 A valid [Arm AVH account](https://www.arm.com/resources/contact-us/virtual-hardware-boards) is required.
 
diff --git a/content/install-guides/cmake.md b/content/install-guides/cmake.md
@@ -36,7 +36,7 @@ This article provides quick instructions to install CMake for Arm Linux distribu
 
 Confirm you are using a Windows on Arm device such as the Lenovo ThinkPad X13s or Surface Pro 9 with 5G.
 
-### How do I prepare to install CMake for Arm Linux distributions?
+### How do I prepare to install CMake on 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.
 
-## How do I download and install on Windows on Arm?
+## How do I download and install CMake 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,11 +74,11 @@ Wait for the installer to complete and click `Finish`:
 
 ![Install #center](/install-guides/_images/cmake-finish.png)
 
-## How do I download and install on Linux?
+## How do I download and install CMake on Linux?
 
 There are multiple ways to install CMake on Linux. 
 
-### How do I use the package manager?
+### How do I install CMake using the package manager?
 
 Use `apt` on Ubuntu and Debian to install:
 
@@ -95,7 +95,7 @@ sudo dnf install cmake -y
 
 Depending on your Linux distribution you may have a version of `cmake` which is too old or too new for your project. 
 
-### How do I use Snap?
+### How do I install the CMake Snap?
 
 Installing with `snap` provides the latest version of `cmake`:
 
@@ -105,7 +105,7 @@ sudo snap install cmake --classic
 
 With `snap` the `cmake` executable is installed in `/snap/bin` which should already be in your search path.
 
-### How do I use a specific release from GitHub?
+### How do I use a specific CMake release from GitHub?
 
 If you need a specific version look for it in the [GitHub releases area](https://github.com/Kitware/CMake/releases)
 
diff --git a/content/install-guides/docker/docker-engine.md b/content/install-guides/docker/docker-engine.md
@@ -39,7 +39,7 @@ The commands can also be used in the Windows Subsystem for Linux 2 (WSL 2) and o
 curl -fsSL get.docker.com -o get-docker.sh && sh get-docker.sh
 ```
 
-### How do I add my user to the Docker group?
+### How do I add my username to the Docker group?
 
 Add the user to the docker group. The `newgrp` command avoids the need to logout and back in.
 
diff --git a/content/install-guides/hyper-v.md b/content/install-guides/hyper-v.md
@@ -92,11 +92,8 @@ The output should include the message:
 The operation completed successfully.
 ```
 
-## Do I need to restart after enabling Hyper-V?
-
 Restart your computer to finish enabling Hyper-V.
 
-
 ## How do I start Hyper-V?
 
 Hyper-V Manager should now be available in the applications menu.
diff --git a/content/install-guides/keilstudio_vs.md b/content/install-guides/keilstudio_vs.md
@@ -35,7 +35,7 @@ layout: installtoolsall         # DO NOT MODIFY. Always true for tool install ar
 
 Alternatively, [Keil Studio Cloud](/install-guides/keilstudiocloud/) provides similar functionality, but runs in a browser and requires no installation. 
 
-## What should I do before I begin?
+## Where can I download Visual Studio Code?
 
 [Download](https://code.visualstudio.com/download), install, and start `Visual Studio Code` on your desktop.
 
@@ -61,7 +61,7 @@ If you have a commercial license for `Keil MDK` installed, decline this option.
 
 Follow the [Getting started with an example project](https://developer.arm.com/documentation/108029/latest/Get-started-with-an-example-project) tutorial to verify the extensions are installed correctly.
 
-## Where can I find more extension information?
+## Where can I find more information about the Keil Studio extensions?
 
 Use the table below to find additional information about the VS Code extensions.
 
diff --git a/content/install-guides/license/ubl_license_admin.md b/content/install-guides/license/ubl_license_admin.md
@@ -33,7 +33,7 @@ sudo apt install -y openjdk-11-jre-headless python-is-python3
 ```
 See [Hardware and software requirements](https://developer.arm.com/documentation/107573/latest/Installing-and-populating-the-license-server/Hardware-and-software-requirements) in the [User-based Licensing Administration Guide](https://developer.arm.com/documentation/107573).
 
-### How do I download and install server software?
+### How do I download and install the server software?
 
 The local license server (LLS) software can be downloaded from:
 ```url
@@ -54,7 +54,7 @@ Waiting for license server... (up to 120 seconds, or press CTRL-C to stop waitin
 License server running and ready to accept requests at http://<external server name or IP address>:7070
 ```
 
-### How do I add the install directory to PATH?
+### How do I add the install directory to the search path?
 
 It is recommended to add the server install directory to the `PATH` so that license server commands can be easily called. For example the default location:
 ```console
diff --git a/content/install-guides/license/ubl_license_enduser.md b/content/install-guides/license/ubl_license_enduser.md
@@ -15,15 +15,15 @@ layout: installtoolsall         # DO NOT MODIFY. Always true for tool install ar
 
 A [Local License Server (LLS)](/install-guides/license/ubl_license_admin/) must first be set up by your license administration team.
 
-## How do I activate a license on my end user machine?
+## How do I activate a license on my computer?
 
 The user-based license can be activated on the end user machine in different ways. Select the most appropriate for your needs.
 
 * [Activate via environment variable](#envvar)
 * [Activate within tools IDE](#ide)
 * [Activate manually](#manual)
 
-## How do I activate via environment variable? {#envvar}
+## How do I activate a license using an environment variable? {#envvar}
 
 Create `ARMLM_ONDEMAND_ACTIVATION` environment variable referencing the product code and your internal license server. Contact your internal license administrators for information on your internal server.
 
@@ -42,15 +42,15 @@ armclang --version
 ```
 You can now [confirm your license has been checked out](#confirm).
 
-## How do I activate within tools IDE? {#ide}
+## How do I activate a license from the tools IDE? {#ide}
 
 The license can also be activated in the various Arm tool IDEs.
 
 For example [Arm Development Studio](https://developer.arm.com/Tools%20and%20Software/Arm%20Development%20Studio), via `Help` > `Arm License Manager` > `Manage Arm User-Based Licenses`.
 
 Select `Activate with` > `License Server`, and enter the appropriate license server address. Click `Query` to see what license types are available, and select the appropriate one from the pull down. Click `Activate`.
 
-## How do I activate manually? {#manual}
+## How do I activate a license manually? {#manual}
 
 Open a command prompt, and navigate to the bin directory of any user-based licensing enabled product.
 
diff --git a/content/install-guides/oci-cli.md b/content/install-guides/oci-cli.md
@@ -23,7 +23,7 @@ The Oracle Cloud Infrastructure Command Line Interface (OCI CLI) is a cross-plat
 
 It is available for a variety of operating systems and Linux distributions and has multiple ways to install it.
 
-## What should I do before installing OCI CLI?
+## What should I do before installing the OCI CLI?
 
 [General installation information](https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/cliinstall.htm#InstallingCLI__linux_and_unix) is available which covers all supported Linux distributions.
 
@@ -43,7 +43,7 @@ aarch64
 
 If you see a different result, you are not using an Arm computer running 64-bit Linux.
 
-## How do I download and install OCI CLI?
+## How do I download and install the OCI CLI?
 
 The easiest way to install OCI CLI for Ubuntu on Arm is to use the install script.
 
@@ -62,15 +62,15 @@ To run an interactive install that allows you to change default values run:
 bash -c "$(curl -L https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.sh)"
 ```
 
-## How do I verify OCI CLI installation?
+## How do I verify the OCI CLI installation?
 
 Verify OCI CLI is installed using the `--version` option:
 
 ```console
 oci --version
 ```
 
-## How do I configure OCI CLI?
+## How do I configure the OCI CLI?
 
 Configure OCI CLI using the `setup config` command:
 
diff --git a/content/install-guides/stm32_vs.md b/content/install-guides/stm32_vs.md
@@ -39,7 +39,7 @@ The tools are available as a [VS Code](https://code.visualstudio.com/) extension
 See [STMicroelectronics provides full STM32 support for Microsoft Visual Studio Code](https://newsroom.st.com/media-center/press-item.html/t4536.html) for more information.
 
 
-## What should I do before I begin?
+## Where can I download Visual Studio Code?
 
 [Download](https://code.visualstudio.com/download), install, and start `Visual Studio Code` on your desktop.
 
diff --git a/content/install-guides/streamline-cli.md b/content/install-guides/streamline-cli.md
@@ -139,7 +139,7 @@ For manual download, you can find all available releases here:
 https://artifacts.tools.arm.com/arm-performance-studio/Streamline_CLI_Tools/
 ```
 
-## Why and how do I apply the kernel patch?
+## How do I apply the kernel patch?
 
 For best results, a Linux kernel patch is available that modifies the behavior of Linux perf to improve support for capturing function-attributed top-down metrics on Arm systems. This patch provides two new capabilities:
 
diff --git a/content/install-guides/streamline.md b/content/install-guides/streamline.md
@@ -45,7 +45,7 @@ The version of Streamline provided with Performance Studio supports [certain And
 
 For other use cases, use Arm Streamline as provided with Arm Development Studio.
 
-## How do I download Streamline installer packages?
+## How do I download Streamline installation packages?
 
 Download the appropriate package from the [Product Download Hub](https://developer.arm.com/downloads).
 
@@ -58,7 +58,7 @@ Arm Development Studio supports Windows and Linux hosts.
 
 ## How do I install Streamline?
 
-### How do I install with Arm Performance Studio?
+### How do I install Streamline with Arm Performance Studio?
 
 Full install instructions are given in section 3 of the Performance Studio [Release Notes](https://developer.arm.com/documentation/107649).
 
@@ -68,7 +68,7 @@ If working with an Android target, you must also install Android Debug Bridge (`
 
 Add the Android SDK platform tools directory to your `PATH` environment variable.
 
-### How do I install with Arm Development Studio?
+### How do I install Streamline with Arm Development Studio?
 
 Install Arm Development Studio using the instructions in the [Arm Development Studio Getting Started Guide](https://developer.arm.com/documentation/101469/latest/Installing-and-configuring-Arm-Development-Studio).
 
