Merge pull request #754 from ArmDeveloperEcosystem/main

Merge to prod

.wordlist.txt

@@ -2238,4 +2238,25 @@ skillset
 supervisord
 UARTs
 USD
-webserver
+webserver
+AEMs
+NLP
+BFloat
+TLP
+lookups
+AoS
+SoA
+acle
+advsimd
+autovectorizing
+wavefunctions
+Structs
+structs
+unfused
+AAarch
+Attr
+osThread
+osThreadPrivileged
+MBL
+MML
+NPCs

assets/css/content.css

@@ -45,12 +45,6 @@ div.markdown-content-div > p {
     margin-bottom: 0px;
 }
 
-div.markdown-content-div > p.content-image-caption {
-    font-style: italic;
-    font-weight: 500;
-    margin-top: 0px;
-}
-
 div.markdown-content-div > ul,
 div.markdown-content-div > ol {
     margin-top: 16px;
@@ -154,11 +148,16 @@ img.content-uploaded-image.centered {
     margin-left: auto;
 }
 
-p.content-image-caption {
+.content-image-caption {
+    /* have to style the span like a paragraph, required for nesting caption in default markdown configruation */
+    display: block; /* or block, depending on the desired layout */
+    font-style: italic;
+    font-weight: 500;
+    margin-top: 0px;
     font-size: 1rem;
 }
 
-p.content-image-caption.centered {
+.content-image-caption.centered {
     text-align: center;
 }
 

assets/css/cross-page.css

@@ -86,6 +86,14 @@ input,
 label {
     font-size: 16px!important;
 }
+/* Overwrite paragraph / heading colors immediatly 
+:root {
+    --ads-font-family:Lato, sans-serif; 
+    --ads-color: hsla(0,0%,100%,.9);
+    --ads-heading-color: hsla(0,0%,100%,.9);
+}
+*/
+
 /* Fix Search Height and pdding*/
 ads-search#search-box {
     min-height: 45px;
@@ -167,7 +175,7 @@ table tbody td {
 /* Fix Nav Masthead Breadcrumb container */
 /*************************************/
 #nav-masthead-breadcrumbs {
-    background-image: url("/img/masthead-background.png"); /* The image used */
+    background-image: url("/img/masthead-background.webp"); /* The image used */
     background-color: var(--arm-color-footing);            /* Used if the image is unavailable */
     background-size: cover;
 }
@@ -382,7 +390,7 @@ html[theme='light'] body {
 /* Mobile background */
 @media (max-width: 768px) {
     html[theme='dark'] body {
-        background-image: url("/img/bg-img-736x800.png"); 
+        background-image: url("/img/bg-img-736x800.webp"); 
         background-color: var(--arm-color-footing);      
         background-position: 0% 100%;
         background-attachment: fixed;
@@ -392,7 +400,7 @@ html[theme='light'] body {
 /* Laptop background */
 @media (min-width: 768px) {
     html[theme='dark'] body {
-        background-image: url("/img/bg-img-1920x1600.png");
+        background-image: url("/img/bg-img-1920x1600.webp");
         background-color: var(--arm-color-footing);      
         background-position: 0% 100%;
         background-attachment: fixed;
@@ -403,7 +411,7 @@ html[theme='light'] body {
 /* Large Monitor background */
 @media (min-width: 1400px) {
     html[theme='dark'] body {
-        background-image: url("/img/bg-img-2500x1700.png");
+        background-image: url("/img/bg-img-2500x1700.webp");
         background-color: var(--arm-color-footing);      
         background-position: 0% 100%;
         background-attachment: fixed;

content/install-guides/armds.md

@@ -38,13 +38,13 @@ Full host platform requirements are given in the [Getting Started Guide](https:/
 
 The installer will depend on the [edition](https://developer.arm.com/Tools%20and%20Software/Arm%20Development%20Studio#Editions) of Development Studio that you are entitled to. 
 
-Gold, Silver, and Bronze editions are one installer, with available features defined by the license. The version is denoted by `year.index`, where `index` is a number (for example `2023.1`). You can also generate an Evaluation license from this installation (`Help` > `Arm License Manager`), with capabilities broadly similar to the Gold Edition.
+The version is denoted by `year.index`, where `index` is a number (for example `2023.1`). You can also generate an Evaluation license from this installation (`Help` > `Arm License Manager`), with capabilities broadly similar to the UBL Gold Edition.
 
 You can download the Development Studio installer from the [Product Download Hub](https://developer.arm.com/downloads/view/DS000B).
 
-Development Studio Platinum Edition has its own installation package. The version is denoted by `year.index`, where `index` is a letter (for example `2023.a`). Platinum Edition is only available to certain Arm licensees.
+Versions of Arm Development Studio denoted by `year.index`, where `index` is a letter (for example `2023.a`) are only available to certain Arm licensees, as they contain support for non publicly announced IP (at time of release).
 
-For more information about the Product Download Hub, refer to the [Product Download Hub installation guide](../pdh).
+For more information about the Product Download Hub, refer to the [Product Download Hub guide](../pdh).
 
 ## Install Arm Development Studio
 
@@ -130,11 +130,11 @@ Launch the IDE from your desktop, or from the above prompt using:
 
 ## Set up the product license
 
-Arm Development Studio is license managed. When you launch the IDE for the first time, you should be prompted to set up your license and select the Edition. You can return to this view from `Help` > `Arm License Manager`.
+Arm Development Studio is license managed. When you launch the IDE for the first time, you should be prompted to set up your license if necessary. You can return to this view from `Help` > `Arm License Manager`.
 
 A free 30 day evaluation license for Arm Development Studio is also available. You can generate this in `Arm License Manager`. Click on `Add`, and follow instructions therein to obtain the evaluation license (requires Arm login).
 
-Alternative license setup instructions are available in the [Arm Licensing install guide](../license/).
+Full license setup instructions are available in the [Arm Software Licensing install guide](../license/).
 
 ## Get started
 

content/install-guides/browsers/brave.md

@@ -51,7 +51,9 @@ For more ways to install Brave on Linux refer to [Installing Brave on Linux](htt
 
 ### Windows 
 
-Brave releases for Windows on Arm are available on [GitHub](https://github.com/brave/brave-browser) 
+Brave is a native ARM64 application. If you visit [brave.com](https://www.brave.com) and download from a Windows on Arm computer you will install the native version. 
+
+Additional Brave releases for Windows on Arm are available on [GitHub](https://github.com/brave/brave-browser) 
 
 To download the offline installer, use the files with `Standalone` in the name. 
 

content/install-guides/browsers/chromium.md

@@ -51,6 +51,7 @@ sudo dnf install chromium -y
   {{< /tab >}}
 {{< /tabpane >}}
 
+Depending on your version of Ubuntu, Chromium may be installed as a snap from the [Canonical Snap Store](https://snapcraft.io/). 
 
 ### Windows 
 

content/install-guides/browsers/edge.md

@@ -9,7 +9,7 @@ additional_search_terms:
 - edge
 
 ### Estimated completion time in minutes (please use integer multiple of 5)
-minutes_to_complete: 1
+minutes_to_complete: 5
 
 author_primary: Jason Andrews
 

content/install-guides/browsers/firefox.md

@@ -59,7 +59,7 @@ To install Firefox on Windows on Arm:
 
 1. Go to the [download page](https://www.mozilla.org/en-US/firefox/all/#product-desktop-release) and select the `Windows ARM64/AArch64` installer. 
 
-2.  Click **Download Now** 
+2. Click **Download Now** 
 
 3. Run the downloaded `.exe` file 
 

content/install-guides/browsers/vivaldi.md

@@ -27,7 +27,7 @@ layout: installtoolsall         # DO NOT MODIFY. Always true for tool install ar
 
 The Vivaldi browser runs on Windows using emulation, but Vivaldi is available for Arm Linux. 
 
-Visit the [download area](https://vivaldi.com/download/) to obtain packages for various operating systems. 
+Visit [Download Vivaldi](https://vivaldi.com/download/) to obtain packages for various operating systems. 
 
 ### Linux
 
@@ -68,7 +68,7 @@ Vivaldi runs on Windows on Arm using emulation.
 
 Emulation is slower than native and shortens battery life, but may provide required functionality.
 
-1. Download the 32-bit Windows version from the [download area](https://vivaldi.com/download/).
+1. Download the 32-bit Windows version from [Download Vivaldi](https://vivaldi.com/download/).
 
 2. Run the downloaded `.exe` file
 

content/install-guides/docker/_index.md

@@ -23,4 +23,4 @@ The operating system of the computer and the architecture (x86 or Arm) will dete
 
 - 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 the 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 (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).
+- 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).

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

@@ -44,7 +44,7 @@ More information is available in the Learning Path [Get started with Windows Sub
 
 ### Install and test Docker Engine
 
-From within `WSL2` running a Linux distribution on a Windows on Arm laptop, the general Linux install instructions can be used. 
+You can use the general Linux install instructions to install Docker in WSL 2 for Windows on Arm. 
 
 ```console
 curl -fsSL test.docker.com -o get-docker.sh && sh get-docker.sh

content/install-guides/fm_fvp/_index.md

@@ -1,6 +1,6 @@
 ---
 title: Arm Fast Models and FVPs
-author_primary: Jason Andrews
+author_primary: Ronan Synnott
 
 additional_search_terms:
     - virtual platform
@@ -19,4 +19,4 @@ layout: installtoolsall         # DO NOT MODIFY. Always true for tool install ar
 
 [Arm Fixed Virtual Platforms (FVPs)](https://developer.arm.com/Tools%20and%20Software/Fixed%20Virtual%20Platforms) are a library of such virtual platforms, built with Fast Model technology.
 
-Arm also provides a range of free-of-charge [Ecosystem Fixed Virtual Platforms (FVPs)](https://developer.arm.com/downloads/-/arm-ecosystem-fvps) targeting different market segments and applications.
+Arm also provides free-of-charge [Ecosystem Fixed Virtual Platforms (FVPs)](https://developer.arm.com/downloads/-/arm-ecosystem-fvps) targeting different market segments and applications, as well as `Arm Architecture Envelope Models`.

content/install-guides/fm_fvp/eco_fvp.md

@@ -1,8 +1,8 @@
 ---
-title: Arm Ecosystem FVPs
+title: Arm Ecosystem FVPs and Architecture Envelope Models
 minutes_to_complete: 15
 official_docs: https://developer.arm.com/documentation/100966
-author_primary: Jason Andrews
+author_primary: Ronan Synnott
 weight: 4
 
 ### FIXED, DO NOT MODIFY
@@ -11,18 +11,26 @@ multi_install: false             # Set to true if first page of multi-page artic
 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
 ---
-Arm Ecosystem FVPs are available free-of-charge. They are supported by relevant Open Source Software projects.
+Arm provides various Fixed Virtual Platforms (FVPs) free of charge.
 
-## Download Ecosystem FVPs
+* Architecture Envelope Models (AEMs) are generic FVPs suitable for early Arm Architecture exploration.
 
-Arm Ecosystem FVPs can be download from [Arm Ecosystem FVPs](https://developer.arm.com/downloads/-/arm-ecosystem-fvps) on the `Arm Developer` website.
+* Arm Ecosystem FVPs model Arm hardware subsystems, and are supported by relevant Open Source Software projects.
 
-## Installation
+Host platform support will vary by FVP.
 
-### Windows
-Unzip the downloaded installation archive.
+## Download
+
+### Architecture Envelope Models
+
+AEM FVPs can be downloaded directly from [Fixed Virtual Platforms](https://developer.arm.com/Tools%20and%20Software/Fixed%20Virtual%20Platforms) on the `Arm Developer` website.
+
+### Ecosystem FVPs
+
+Arm Ecosystem FVPs can be download from [Arm Ecosystem FVPs](https://developer.arm.com/downloads/-/arm-ecosystem-fvps) on the `Arm Developer` website.
 
-Run the installer (`<FVP_name>.msi`), and follow on-screen instructions.
+
+## Installation
 
 ### Linux
 Unpack the downloaded package, and install the FVP library with the supplied script. For example:
@@ -33,15 +41,22 @@ For full list of available options, use `--help`:
 ```command
 ./FVP_Corstone_1000.sh --help
 ```
+
+### Windows
+
+Unzip the downloaded installation archive.
+
+Run the installer (`<FVP_name>.msi`), and follow on-screen instructions.
+
 ## Verify installation
 
-Arm Ecosystem FVPs are not license managed.
+Arm Ecosystem FVPs and AEMs are not license managed.
 
-To verify everything is working OK, run the installed FVP executable, located in the `models/<build_environment>` folder of the installed directory. No additional command options are needed.
+To verify everything is working OK, run the installed FVP executable, located in the `models/<build_environment>` folder of the installed directory. No additional command options are needed for this step.
 
 For example:
 ```command
-./models/Linux64_GCC-9.3/FVP_Corstone-1000
+./FVP_Corstone-1000
 ```
 The FVP will launch, and output text in a terminal similar to:
 ```output
@@ -56,4 +71,6 @@ Terminate the FVP with `Ctrl+C`.
 
 ## Integration with Arm Toolchains
 
-Arm Ecosystem FVPs can be used in conjunction with [Arm Development Studio](/install-guides/armds) or [Keil MDK](/install-guides/mdk) (Cortex-M FVPs only) to provide a debug target without the need for real hardware.
+These FVPs can be used in conjunction with [Arm Development Studio](/install-guides/armds) or [Keil MDK](/install-guides/mdk) (Cortex-M FVPs only) to provide a debug target without the need for real hardware.
+
+Some of these FVPs are also directly supplied with these toolchains.

content/install-guides/fm_fvp/fm.md

@@ -2,7 +2,7 @@
 title: Arm Fast Models
 minutes_to_complete: 15
 official_docs: https://developer.arm.com/documentation/107572
-author_primary: Jason Andrews
+author_primary: Ronan Synnott
 weight: 2
 
 ### FIXED, DO NOT MODIFY
@@ -23,15 +23,17 @@ Arm Fast Models are a library of components that are used to build a virtual pla
 
 Therefore to build such an executable, you must ensure that the appropriate host toolchain is installed.
 
-For Linux hosts, use `gcc` versions `7.3.0` or `9.3.0` depending on OS version.
+For Windows hosts, [Visual Studio 2019](https://visualstudio.microsoft.com/vs/older-downloads/) 16.11 (or later). Express or Community editions can NOT be used.
 
-For Windows hosts use [Visual Studio 2019](https://visualstudio.microsoft.com/vs/older-downloads/) 16.7.3 (or later). Express or Community editions can NOT be used.
+For Linux hosts, the supported `gcc` version depends on the Host OS.
 
-More information is provided in the [Fast Models User Guide](https://developer.arm.com/documentation/100965/latest/Installing-Fast-Models/Requirements-for-Fast-Models).
+The [Fast Models User Guide](https://developer.arm.com/documentation/100965/latest/Installing-Fast-Models/Requirements-for-Fast-Models) provides full details.
 
 ## Download installer packages
 
-You can download the Fast Models installer from the [Product Download Hub](https://developer.arm.com/downloads/view/FM000A). Linux (AArch64 and x86) and Windows (x86 only) hosts are supported.
+You can download the Fast Models installation package from the [Product Download Hub](https://developer.arm.com/downloads/view/FM000A).
+
+Linux (AArch64 and x86) and Windows (x86 only) hosts are supported.
 
 For more information about the Product Download Hub, refer to the [Product Download Hub installation guide](/install-guides/pdh).
 
@@ -43,7 +45,9 @@ Unzip the downloaded installation archive.
 
 It is easiest to run the installation wizard (`setup.exe`), and follow on-screen instructions.
 
-Once installed, open the `System Canvas` IDE, and select `File` > `Preferences` > `Applications` from the menu. Set the `Path to Microsoft Viaual C++ application devenv.com` to your Visual Studio installation (`<install_dir>\Common7\IDE`). Click `OK` to save.
+Once installed, open the `System Canvas` IDE, and select `File` > `Preferences` > `Applications` from the menu.
+
+Set the `Path to Microsoft Viaual C++ application devenv.com` to your Visual Studio installation (`<install_dir>\Common7\IDE`). Click `OK` to save.
 
 ### Linux
 
@@ -67,14 +71,15 @@ Full instructions are provided in the [Fast Models User Guide](https://developer
 
 Arm Fast Models are license managed. License setup instructions are available in the [Arm Licensing install guide](/install-guides/license).
 
+
 ## Verify installation
 
 To verify everything is working OK, you can build one of the many example projects provided.
  - Launch the `System Canvas` IDE from your desktop, or from a terminal:
  ```command
  sgcanvas &
  ```
-  - From the menu, select `File` > `Load Project`, and browse to the `FastModelsPortfolio_<version>\examples` folder.
+ - From the menu, select `File` > `Load Project`, and browse to the `FastModelsPortfolio_<version>\examples` folder.
  - Select any example (such as `\LISA\FVP_MPS2\Build_Cortex-M3\FVP_MPS2_Cortex-M3.sgproj`).
  - Ensure an appropriate Project Configuration is selected from the pulldown in the upper toolbar (such as `Win64_Release-VC19`).
  - Click `Build` in the upper toolbar to build the virtual platform.

content/install-guides/fm_fvp/fvp.md

@@ -2,7 +2,7 @@
 title: Fixed Virtual Platforms (FVP)
 minutes_to_complete: 15
 official_docs: https://developer.arm.com/documentation/100966/
-author_primary: Jason Andrews
+author_primary: Ronan Synnott
 weight: 3    
 
 ### FIXED, DO NOT MODIFY
@@ -19,7 +19,9 @@ An appropriate subset of the FVP library is installed with [Arm Development Stud
 
 ## Download installer packages
 
-You can download the FVP library installer from the [Product Download Hub](https://developer.arm.com/downloads/view/FM000A). Linux (AArch64 and x86) and Windows (x86 only) hosts are supported.
+You can download the FVP library installer from the [Product Download Hub](https://developer.arm.com/downloads/view/FM000A).
+
+Linux (AArch64 and x86) and Windows (x86 only) hosts are supported.
 
 For more information about the Product Download Hub, refer to the [Product Download Hub installation guide](/install-guides/pdh).