Merge pull request #1421 from ArmDeveloperEcosystem/main

Production update

.wordlist.txt

@@ -577,7 +577,6 @@ Pmod
 PostgerSQL
 PostgrSQL
 Postgres
-Powershell
 Prefetching
 Prereqs
 ProjectExplorer
@@ -3336,4 +3335,49 @@ webgpufundamentals
 wgpuQueueSubmit
 wgpuQueueWriteBuffer
 wgpuQueueWriteTexture
-wpa
+wpa
+CAMs
+CODENAME
+COMs
+Chaodong
+CreateWorkload
+Disqus
+ExecuteNetwork
+FPC
+HX
+Hejmadi
+Himax
+Kieran
+LHwilBhvNU
+LastWriteTime
+LiteRT
+OV
+Seeed
+WebGPU’s
+WiseEye
+Yolov
+blp
+dLayer
+dawnwebgpu
+dmesg
+fm
+himax
+il
+juXXgrDDaUdmi
+mins
+mobilenet
+msvc
+od
+ons
+scm
+seeedstudio
+sscript
+tflm
+tw
+vc
+videoio
+wiseeye
+wlcsp
+xB
+xmodem
+yolov

assets/contributors.csv

@@ -43,7 +43,7 @@ Rin Dobrescu,Arm,,,,
 Przemyslaw Wirkus,Arm,PrzemekWirkus,przemyslaw-wirkus-78b73352,,
 Nader Zouaoui,Day Devs,nader-zouaoui,nader-zouaoui,@zouaoui_nader,https://daydevs.com/
 Alaaeddine Chakroun,Day Devs,Alaaeddine-Chakroun,alaaeddine-chakroun,,https://daydevs.com/
-Koki Mitsunami,Arm,,,,
+Koki Mitsunami,Arm,,kmitsunami,,
 Chen Zhang,Zilliz,,,,
 Tianyu Li,Arm,,,,
 Georgios Mermigkis,VectorCamp,gMerm,georgios-mermigkis,,https://vectorcamp.gr/ 

content/install-guides/acfl.md

@@ -142,6 +142,33 @@ install takes place **after** ACfL, you will no longer be able to fully
 uninstall ACfL.
 {{% /notice %}}
 
+## Download and install using System Packages - Ubuntu Linux
+
+Arm Compiler for Linux is available to install with the Ubuntu system package manager `apt` command.
+
+### Setup the ACfL package repository:
+
+Add the ACfL `apt` package repository to your Ubuntu 20.04 or 22.04 system:
+
+```bash { target="ubuntu:latest" }
+sudo apt update
+sudo apt install -y curl
+source /etc/os-release
+curl "https://developer.arm.com/packages/ACfL%3A${NAME}-${VERSION_ID/%.*/}/${VERSION_CODENAME}/Release.key" | sudo tee /etc/apt/trusted.gpg.d/developer-arm-com.asc
+echo "deb https://developer.arm.com/packages/ACfL%3A${NAME}-${VERSION_ID/%.*/}/${VERSION_CODENAME}/ ./" | sudo tee /etc/apt/sources.list.d/developer-arm-com.list
+sudo apt update
+```
+
+The ACfL Ubuntu package repository is now ready to use.
+
+### Install ACfL
+
+Download and install Arm Compiler for Linux with:
+
+```bash { target="ubuntu:latest" }
+sudo apt install acfl
+```
+
 ### Set up environment
 
 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.

content/install-guides/git-woa.md

@@ -0,0 +1,105 @@
+---
+### Title the install tools article with the name of the tool to be installed
+### Include vendor name where appropriate
+title: Git for Windows on Arm
+
+### Optional additional search terms (one per line) to assist in finding the article
+additional_search_terms:
+- git
+- windows
+- woa
+- windows on arm
+- open source windows on arm
+
+### Estimated completion time in minutes (please use integer multiple of 5)
+minutes_to_complete: 10
+
+### Link to official documentation
+official_docs: https://git-scm.com/doc
+
+author_primary: Jason Andrews
+
+### PAGE SETUP
+weight: 1                       # Defines page ordering. Must be 1 for first (or only) page.
+tool_install: true              # Set to true to be listed in main selection page, else false
+multi_install: false            # Set to true if first page of multi-page article, else false
+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
+---
+
+Git has native support for [Windows on Arm](https://learn.microsoft.com/en-us/windows/arm/overview). Starting with version 2.47.1, an official installer is available. 
+
+In addition to Windows laptops, Windows on Arm instances are available with Microsoft Azure. For further information, see [Deploy a Windows on Arm virtual machine on Microsoft Azure](/learning-paths/cross-platform/woa_azure/).
+
+## How do I download and install Git for Windows on Arm?
+
+Git releases are available in [GitHub releases](https://github.com/git-for-windows/git/releases/).
+
+Use a browser to download the desired release file. The Git releases for Windows on Arm have `arm64.exe` in the filename.
+
+You can also download from a Windows PowerShell with the following command:
+
+```command
+curl https://github.com/git-for-windows/git/releases/download/v2.47.1.windows.1/Git-2.47.1-arm64.exe -o Git-2.47.1-arm64.exe
+```
+
+Once you have downloaded Git, run the installer `.exe` file on a Windows on Arm machine. 
+
+The installer starts. 
+
+Click **Next** to acknowledge the GNU General Public License.
+
+Set the destination location or accept the default location, and click **Next**.
+
+Continue to click **Next** for the configuration settings. You can accept all defaults if you are unsure of specific settings.
+
+At the end of the install process, you see the screen below indicating setup has finished installing Git:
+
+![Install](/install-guides/_images/git-woa.png)
+
+Click the **Finish** button to complete installation. 
+
+## How do I use Git on Windows? 
+
+You can use Git on Windows from a Command Prompt or using Git Bash. 
+
+Git Bash is a Linux-like terminal experience which includes Git and many other Linux commands. 
+
+{{% notice Note %}}
+Git is not automatically added to your search path during installation. 
+{{% /notice %}}
+
+To use Git, click the Windows **Start** button and then click **All apps**.
+
+You see the Git folder in the G section.
+
+![Start](/install-guides/_images/git2-woa.png)
+
+There are menu items for multiple ways to start Git. 
+
+## How can I use Git in a Windows Command Prompt?
+
+Start a Git Command Prompt by selecting **Git CMD** from the **Start** menu.
+
+![CMD](/install-guides/_images/git3-woa.png)
+
+
+To see the help message, enter:
+
+```cmd
+git help
+```
+
+You can use Git from this Command Prompt. 
+
+## How can I use Git with Git Bash?
+
+To use Git in a Linux-like environment, select **Git Bash** from the start menu.
+
+![CMD](/install-guides/_images/git4-woa.png)
+
+Click the colored icon in the top-left corner of the Git Bash window, and then click **Options** to change the appearance of the window, including colors, fonts, and font sizes. 
+
+![Options](/install-guides/_images/git5-woa.png)
+
+You are now ready to use Git on your Windows on Arm device. 

content/install-guides/windows-perf-wpa-plugin.md

@@ -1,10 +1,6 @@
 ---
 title: Windows Performance Analyzer (WPA) plugin
 
-draft: true
-cascade:
-    draft: true
-
 minutes_to_complete: 15
 
 official_docs: https://github.com/arm-developer-tools/windowsperf-wpa-plugin
@@ -34,18 +30,18 @@ layout: installtoolsall # DO NOT MODIFY. Always true for tool install articles
 
 The Windows Performance Analyzer (WPA) plugin connects [WindowsPerf](/learning-paths/laptops-and-desktops/windowsperf/) to the Windows Performance Analyzer. Windows Perf is a lightweight performance profiling tool inspired by Linux Perf and designed for Windows on Arm.
 
-Windows Performance Analyzer is a useful tool that supports developers with diagnostics and performance tuning. It generates data tables and graphs of Event Tracing for Windows (ETW) events, which are recorded in one of three ways:
-- Windows Performance Recorder (WPR)
-- Xperf
-- or through an assessment that's run in the Assessment Platform.
+Windows Performance Analyzer provides developers with diagnostics and performance tuning. It generates data tables and graphs of Event Tracing for Windows (ETW) events, which are recorded in one of three ways:
+- By using Windows Performance Recorder (WPR).
+- By using Xperf.
+- Through an assessment that is run in the Assessment Platform.
 
-WPA can open event trace log (ETL) files, which you can use for analysis.
+WPA can open Event Trace Log (ETL) files, which you can use for analysis.
 
-The WPA plugin is built using the [Microsoft Performance Toolkit SDK](https://github.com/microsoft/microsoft-performance-toolkit-sdk), a collection of tools to create and extend performance analysis applications. The plugin parses JSON output from Windows Perf so that it can be visualized in WPA. 
+The WPA plugin is built using the [Microsoft Performance Toolkit SDK](https://github.com/microsoft/microsoft-performance-toolkit-sdk), which is a collection of tools to create and extend performance analysis applications. The plugin parses JSON output from Windows Perf so that it can be visualized in WPA. 
 
-## What are some of the features of the WPA plugin? 
+## What are the features of the WPA plugin? 
 
-The WindowsPerf GUI extension includes features, which are designed to streamline the user experience:
+The WindowsPerf GUI extension includes features that are designed to streamline the user experience, and these are detailed below.
 
 ### Timeline view
 
@@ -61,83 +57,87 @@ The telemetry view displays telemetry events grouped by unit:
 
 ## How do I install the WPA plugin?
 
-Before installing the plugin, you need to make sure you have installed WPA:
+Before installing the plugin, you need to install WPA.
 
 ### Install WPA
 
-WPA is included in the Windows Assessment and Deployment Kit (Windows ADK), which you can download from [Microsoft](https://go.microsoft.com/fwlink/?linkid=2243390).
+For Windows on Arm devices, you can install WPA from the Microsoft Store.
 
-{{% notice Note %}}
-The WPA plugin requires WPA version `11.0.7.2` or higher.
-{{% /notice %}}
+Open the Microsoft Store and search for "windows performance analyzer".
 
-Run the downloaded `adksetup.exe` program. 
+![WPA store](/install-guides/_images/wpa-store.png)
 
-Specify the default installation location and accept the license agreement. 
+Hover over the card, and you will see that the **Free** button becomes a **Get** button. Click the **Get** button to start the installation. 
 
-Make sure that **Windows Performance Toolkit** is checked under **Select the features you want to install**.
+Wait for WPA to be installed, and then launch it from the Windows menu.
 
-![WPA Installation](/install-guides/_images/wpa-installation.png)
+![WPA installation #center](/install-guides/_images/wpa-installation.png)
 
-Finally, click **Install**.
+{{% notice Note %}}
+The WPA plugin requires WPA version `11.0.7.2` or higher. You can check the version by clicking **Help** > **About Windows Performance Analyzer**.
+{{% /notice %}}
+
+Close Windows Performance Analyzer.
 
 ### Install the WPA plugin
 
-Now you're ready to install the plugin, which is a single `.dll` file.
+You are now ready to install the WPA plugin, which is a single `.dll` file.
 
 Download the `.zip` file from the [Windows Perf WPA plugin GitHub releases page](https://github.com/arm-developer-tools/windowsperf-wpa-plugin/releases) on GitHub.
 
-Alternatively, you can download the latest version using command prompt:
+Alternatively, you can download the `.zip` file from a command prompt:
 
 ```console
 mkdir wpa-plugin
 cd wpa-plugin
-curl -L -O https://github.com/arm-developer-tools/windowsperf-wpa-plugin/releases/download/1.0.2/wpa-plugin-1.0.2.zip
+curl -L -O https://github.com/arm-developer-tools/windowsperf-wpa-plugin/releases/download/1.0.3/wpa-plugin-1.0.3.zip
 ```
 
-Now extract the `.dll` file from the downloaded `.zip` file. 
+Extract the `.dll` file from the downloaded `.zip` file. 
 
 ```console
-tar -xmf wpa-plugin-1.0.2.zip
+tar -xmf wpa-plugin-1.0.3.zip
 ```
 
 The file `WPAPlugin.dll` is now in your `wpa-plugin` directory. 
 
-There are three ways you can install the `WPAPlugin.dll` file: 
+There are three ways that you can use the `WPAPlugin.dll` file: 
 
-#### 1. Copy the .dll file to the CustomDataSources directory next to the WPA executable.
+##### Option 1: Start WPA from the command line and pass the plugin directory location using a flag.
 
-The default location is: 
-        `C:\\Program Files (x86)\Windows Kits\10\Windows Performance Toolkit\CustomDataSources`
+Use the `-addsearchdir` flag to tell `wpa` where to find plugins.
 
-#### 2. Set an environment variable.
+For example, if you downloaded the `.dll` in your `Downloads` directory, you can run `wpa` as shown below:
+
+```bash
+wpa -addsearchdir %USERPROFILE%\Downloads\wpa-plugin-1.0.3
+```
+        
+##### Option 2: Set an environment variable.
 
 Set the `WPA_ADDITIONAL_SEARCH_DIRECTORIES` environment variable to the location of the `.dll` file.
 
-#### 3. Start WPA from the command line and pass the plugin directory location using a flag.
+##### Option 3: Copy the  `.dll` file to the `CustomDataSources` directory next to the WPA executable.
 
-Use the `-addsearchdir` flag for `wpa`:
+The default location is: 
+        `C:\\Program Files (x86)\Windows Kits\10\Windows Performance Toolkit\CustomDataSources`
 
-```bash
-wpa -addsearchdir "%USERPROFILE%\plugins"
-```
-        
-## How can I verify the WPA plugin is installed?
+## How can I verify that the WPA plugin is installed?
 
-To verify the plugin is loaded, launch WPA and the plugin should appear under **Help > About Windows Performance Analyzer**.
+To verify the plugin is loaded, launch WPA and the plugin should appear on the Installed Plugins list.
 
-![WPA installation confirmation](/install-guides/_images/about-wpa.png)
+![WPA installation confirmation](/install-guides/_images/wpa-install-plugin.png)
 
 ## How can I run the WPA plugin from the command line?
 
 To open a JSON file directly from the command line, you can use the `-i` flag to specify the file path to open.
 
-For example: to open `timeline_long.json` in your downloads directory, run the command:
+For example, to open `timeline_long.json` in your  `downloads` directory, run the command:
 
 ```console
-wpa -i "%USERPROFILE%\\Downloads\\timeline_long.json"
+wpa -addsearchdir %USERPROFILE%\Downloads\wpa-plugin-1.0.3 -i %USERPROFILE%\Downloads\timeline_long.json
 ```
 ## How do I uninstall the WPA plugin?
 
-To uninstall the plugin simply delete the `WPAPlugin.dll` file.
+To uninstall the plugin, simply delete the `WPAPlugin.dll` file.