UDX milestone 1 production

.github/workflows/deploy.yml

@@ -17,6 +17,8 @@ on:
         required: true
       HUGO_LLM_API:
         required: true
+      HUGO_RAG_API:
+        required: true
 
 env:
   HUGO_VERSION: 0.130.0
@@ -60,6 +62,7 @@ jobs:
           bin/pagefind --site "public"
         env:
           HUGO_LLM_API: ${{ secrets.HUGO_LLM_API }}
+          HUGO_RAG_API: ${{ secrets.HUGO_RAG_API }}
 
       # Deploys website to AWS S3 and invalidate CloudFront Cache
       - name: Deploy to S3

.github/workflows/external-links.yml

@@ -33,7 +33,7 @@ jobs:
           pip install linkchecker 
           linkchecker --no-robots --config .linkcheckerrc --check-extern https://learn.arm.com/learning-paths/laptops-and-desktops/
           linkchecker --no-robots --config .linkcheckerrc --check-extern https://learn.arm.com/learning-paths/servers-and-cloud-computing/
-          linkchecker --no-robots --config .linkcheckerrc --check-extern https://learn.arm.com/learning-paths/smartphones-and-mobile/
-          linkchecker --no-robots --config .linkcheckerrc --check-extern https://learn.arm.com/learning-paths/embedded-systems/
-          linkchecker --no-robots --config .linkcheckerrc --check-extern https://learn.arm.com/learning-paths/microcontrollers/
-
+          linkchecker --no-robots --config .linkcheckerrc --check-extern https://learn.arm.com/learning-paths/mobile-graphics-and-gaming/
+          linkchecker --no-robots --config .linkcheckerrc --check-extern https://learn.arm.com/learning-paths/embedded-and-microcontrollers/
+          linkchecker --no-robots --config .linkcheckerrc --check-extern https://learn.arm.com/learning-paths/iot/
+          linkchecker --no-robots --config .linkcheckerrc --check-extern https://learn.arm.com/learning-paths/automotive/

.github/workflows/main.yml

@@ -22,3 +22,4 @@ jobs:
     secrets:
       AWS_OIDC_ROLE: ${{ secrets.AWS_OIDC_ROLE_INTERNAL }}
       HUGO_LLM_API: ${{ secrets.HUGO_LLM_API }}
+      HUGO_RAG_API: ${{ secrets.HUGO_RAG_API }}

.gitignore

@@ -9,3 +9,5 @@ package-lock.json
 # macOS files
 *.DS_Store
 nohup.out
+
+venv/

.htmltest.yml

@@ -1,12 +1,12 @@
 DirectoryPath: "public"
 IgnoreDirectoryMissingTrailingSlash: True
 IgnoreURLs:
-- "fonts.gstatic.com"
-- "github.com"
-- "linkedin.com"
-- "marketplace.visualstudio.com"
-- "www.microsoft.com"
-- "localhost"
-- "127.0.0.1"
-- "192.168.64.39"
-- "/livereload.js"
+  - "fonts.gstatic.com"
+  - "github.com"
+  - "linkedin.com"
+  - "marketplace.visualstudio.com"
+  - "www.microsoft.com"
+  - "localhost"
+  - "127.0.0.1"
+  - "192.168.64.39"
+  - "/livereload.js"

assets/css/content-pages.css

@@ -218,3 +218,54 @@ html[theme='dark'] .incorrect-explain {color: #e86868} /* 27% lighter than arm's
 .info_text_preexplination.smooth-open {
     opacity: 1;
 }
+
+
+
+
+/* Subtitle (for Next steps styling) */
+/**************************************/
+.next-steps-subtitle {
+    color: var(--arm-black);
+    font-family: "Source Code Pro", monospace;
+    font-weight: lighter;
+    color:  #A3A8AE;
+    margin-top: 0px;
+    margin-bottom: 4px;
+}
+
+
+
+.social-icons {
+    display: flex;
+    gap: 15px;
+    align-items: center;
+}
+.social-icons a {
+    color: var(--arm-light-blue);
+    font-size: 36px;
+    text-decoration: none;
+}
+.social-icons a:hover {
+    color: var(--arm-green);
+}
+
+.share-icon {
+    width: 36px;
+    height: 36px;
+    fill: var(--arm-light-blue);
+    text-decoration: none;
+}
+.share-icon:hover {
+    fill: var(--arm-green);
+    cursor: pointer;
+  }
+#link-copied-success {
+    color: var(--arm-green);
+    background-color: var(--arm-black);
+    border-radius: 10px;
+    padding-left:8px;
+    padding-top: 4px;
+    padding-bottom: 6px;
+    padding-right: 16px;
+    font-size: 16px;
+}

assets/css/demo.css

@@ -21,17 +21,17 @@
 
 
 .eq-width-cols {
-    max-width: calc(100% / var(--column-count)); /* Calculate the max-width based on the number of columns */
+    max-width: calc(90% / var(--column-count)); /* Calculate the max-width based on the number of columns */
 }
 @media (min-width: 992px) { /* lg */
     .eq-width-cols {
-        max-width: calc(100% / var(--column-count));  /* Calculate the max-width based on the number of columns */
+        max-width: calc(90% / var(--column-count));  /* Calculate the max-width based on the number of columns */
     }
 }
 
 @media (max-width: 576px) { /* xs */
     .eq-width-cols {
-        max-width: 100%;
+        max-width: 90%;
         flex-basis: 100%; /* Stacks the columns vertically on smaller screens */
     }
 }
@@ -114,7 +114,9 @@
 /* Demo section */
 
 #all-messages-div {
-    height: 300px;
+    min-height: 300px;
+    max-height: 600px;
+    height: auto;
     display: flex;
     flex-direction: column-reverse;
     overflow-y: auto;
@@ -251,6 +253,18 @@
     font-style: italic;
 }
 
+.chatbot-response-text {
+    max-width: 100%;
+    display: flex;
+    flex-direction: column;
+    gap: 0;
+}
+.chatbot-response-text * {
+    max-width: 98%;
+    margin-bottom: 8px;
+    line-height: 1.3;
+}
+
 
 
 

assets/events.csv

@@ -0,0 +1,15 @@
+Name,Priority,Start Date,End Date,City,Country,Virtual Option,Description,URL,Categories
+Everything Open,2,2025-01-20,2025-01-22,Tarntanya,Australia,FALSE,Example description. Example description. Example description. Example description. Example description.,https://everythingopen.au/,Servers and Cloud Computing; AI; IoT
+FOSDEM 25,2,2025-02-01,2025-02-02,Brussels,Belgium,FALSE,Example description. Example description. Example description. Example description. Example description.,https://fosdem.org/2025/,AI; Servers and Cloud Computing; IoT; Embedded and Microcontrollers
+State of Open,2,2025-02-04,2025-02-05,London,United Kingdom,FALSE,Example description. Example description. Example description. Example description. Example description.,https://stateofopencon.com/,Servers and Cloud Computing; AI; IoT
+Arm AI Innovation Day,2,2025-02-15,2025-02-15,Nairobi,Kenya,,Example description. Example description. Example description. Example description. Example description.,TBC,AI
+Rust Nation,2,2025-02-19,2025-02-20,London,United Kingdom,FALSE,Example description. Example description. Example description. Example description. Example description.,https://www.rustnationuk.com/,Embedded and Microcontrollers; AI; IoT
+SOSS Policy Summit,2,2025-03-04,2025-03-04,Washington,United States,FALSE,Example description. Example description. Example description. Example description. Example description.,https://events.linuxfoundation.org/openssf-policy-summit-dc/,Servers and Cloud Computing
+SCaLE,1,2025-03-06,2025-03-09,Pasadena,United States,FALSE,SCaLE is the largest community-run open-source and free software conference in North America. It is held annually in the greater Los Angeles area.,https://www.socallinuxexpo.org/scale/22x,Servers and Cloud Computing
+SUSECon,2,2025-03-10,2025-03-14,Orlando,United States,FALSE,Example description. Example description. Example description. Example description. Example description.,https://www.suse.com/susecon/,Servers and Cloud Computing; AI; IoT
+Embedded World,1,2025-03-11,2025-03-13,Nuremburg,Germany,FALSE,"Embedded World offers insight into the world of embedded systems, from components and modules to operating systems, hardware and software design, M2M communication, and more.",https://www.embedded-world.de/en,Embedded and Microcontrollers; Automotive
+FOSSAsia,2,2025-03-13,2025-03-15,Bangkok,Thailand,TRUE,Example description. Example description. Example description. Example description. Example description.,https://events.fossasia.org/,Servers and Cloud Computing; AI; IoT
+NVIDIA GTC,1,2025-03-17,2025-03-21,San Jose,United States,TRUE,"Nvidia GTC is a global artificial intelligence conference for developers that brings together developers, engineers, researchers, inventors, and IT professionals. ",https://www.nvidia.com/gtc/,ML
+GDC,1,2025-03-17,2025-03-21,San Fransisco,United States,FALSE,"The Game Developers Conference (GDC) is the worldÕs premier event for developers who make the games we love. GDC is the destination for creativity, innovation, and excellence.",https://gdconf.com/,"Mobile, Graphics, and Gaming"
+ATO AI,2,2025-03-17,2025-03-18,Durham,United States,,Example description. Example description. Example description. Example description. Example description.,https://allthingsopen.ai/,AI
+KubeCon EU,2,2025-04-01,2025-04-04,London ,United Kingdom,TRUE,Example description. Example description. Example description. Example description. Example description.,https://events.linuxfoundation.org/kubecon-cloudnativecon-europe/,Servers and Cloud Computing

config.toml

@@ -23,6 +23,11 @@ name = "production"
 URL = "s3://arm-learning-paths?region=us-west-2"
 cloudFrontDistributionID = "E2NEF61QWPFRIH"
 
+[markup]
+  [markup.goldmark]
+    [markup.goldmark.renderer]
+      unsafe = true
+
 [frontmatter]
 lastmod = ["lastmod", ":git", "date", "publishDate"]
 

content/install-guides/ams.md

@@ -66,4 +66,4 @@ Run the supplied `Arm_Performance_Studio_<version>_macos_x86-64.dmg` installer,
 
 ## Get started
 
-See the [Get started with Arm Performance Studio for Mobile](/learning-paths/smartphones-and-mobile/ams/) learning path for a collection of tutorials for each component of 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/armds.md

@@ -144,4 +144,4 @@ To verify everything is working OK, run the compiler from your command prompt:
 ```command
 armclang --version
 ```
-You should now be ready to use Arm Development Studio. See the [Get started with Arm Development Studio](/learning-paths/embedded-systems/armds/) learning path for more information.
+You should now be ready to use Arm Development Studio. See the [Get started with Arm Development Studio](/learning-paths/embedded-and-microcontrollers/armds/) learning path for more information.

content/install-guides/cmsis-toolbox.md

@@ -41,7 +41,7 @@ Windows, Linux, and macOS host platforms are supported.
 {{% notice Note %}}
 This install guide is for manual installation of `CMSIS-Toolbox`.
 
-For automation instructions using `vcpkg` see [Install tools on the command line using vcpkg](/learning-paths/microcontrollers/vcpkg-tool-installation/).
+For automation instructions using `vcpkg` see [Install tools on the command line using vcpkg](/learning-paths/embedded-and-microcontrollers/vcpkg-tool-installation/).
 
 `CMSIS-Toolbox` is also installed as part of a Keil MDK installation (Windows only).
 {{% /notice %}}

content/install-guides/streamline.md

@@ -96,4 +96,4 @@ Depending on your type of application, choose the appropriate guide below to get
 
 For Android users, a thorough [tutorial](https://developer.arm.com/documentation/102477) is also available.
 
-See also the [Get started with Arm Performance Studio](/learning-paths/smartphones-and-mobile/ams/) learning path.
+See also the [Get started with Arm Performance Studio](/learning-paths/mobile-graphics-and-gaming/ams/) learning path.

content/learning-paths/automotive/_index.md

@@ -0,0 +1,19 @@
+---
+differentiating_info:
+- ADAS
+- Powertrain
+- IVI
+key_ip:
+- Cortex-A
+- Cortex-R
+maintopic: true
+subtitle: Build secure, connected, smart IoT devices
+title: Automotive
+weight: 4
+subjects_filter:
+- Containers and Virtualization: 1
+operatingsystems_filter:
+- Linux: 1
+tools_software_languages_filter:
+- Automotive: 1
+---

content/learning-paths/automotive/intro/_index.md

@@ -0,0 +1,38 @@
+---
+title: Get started with Automotive
+
+minutes_to_complete: 10
+
+who_is_this_for: This is an introductory topic for software developers working on Automotive applications and new to the Arm architecture.
+
+learning_objectives:
+    - Understand where the Arm architecture is used in Automotive devices.
+    - Find Automotive devices to use for software development.
+
+prerequisites:
+    - None
+
+draft: true
+cascade:
+    draft: true
+
+author_primary: Jason Andrews
+
+### Tags
+skilllevels: Introductory
+subjects: Performance and Architecture
+armips:
+    - Cortex-M
+    - Ethos-U
+operatingsystems:
+    - Baremetal
+    - RTOS
+tools_software_languages:
+
+
+### FIXED, DO NOT MODIFY
+# ================================================================================
+weight: 1                       # _index.md always has weight of 1 to order correctly
+layout: "learningpathall"       # All files under learning paths have this same wrapper
+learning_path_main_page: "yes"  # This should be surfaced when looking for related content. Only set for _index.md of learning path content.
+---

content/learning-paths/microcontrollers/intro/_next-steps.md → content/learning-paths/automotive/intro/_next-steps.md

@@ -7,7 +7,7 @@ next_step_guidance: >
    The Machine Learning (ML) capabilities of embedded devices is rapidly increasing. Why not learn about ML development?
 # 1-3 sentence recommendation outlining how the reader can generally keep learning about these topics, and a specific explanation of why the next step is being recommended.
 
-recommended_path: "/learning-paths/microcontrollers/nav-mlek/"
+recommended_path: "/learning-paths/embedded-and-microcontrollers/nav-mlek/"
 
 # further_reading links to references related to this path. Can be:
     # Manuals for a tool / software mentioned   (type: documentation)

content/learning-paths/microcontrollers/intro/background.md → content/learning-paths/automotive/intro/background.md

@@ -23,4 +23,4 @@ The Arm Cortex-M ecosystem offers a wide range of software options, including br
 
 The [Common Microcontroller Software Interface Standard (CMSIS)](https://www.keil.arm.com/cmsis) is a vendor-independent abstraction layer for microcontrollers. CMSIS simplifies software reuse and reduces the learning curve for microcontroller developers.
 
-Proceed to the next page to find Arm hardware or browse [Microcontrollers](/learning-paths/microcontrollers/) to start learning.
+Proceed to the next page to find Arm hardware or browse [Microcontrollers](/learning-paths/embedded-and-microcontrollers/) to start learning.

content/learning-paths/cross-platform/_example-learning-path/write-1-init.md

@@ -10,12 +10,13 @@ layout: "learningpathall"
 
 ## Add a new Learning Path
 
-To add a new Learning Path, first decide the appropriate category. There are 5 categories into which you can contribute content:
+To add a new Learning Path, first decide the appropriate category. There are 6 categories into which you can contribute content:
 * servers-and-cloud-computing
 * laptops-and-desktops
-* embedded-systems
-* microcontrollers
-* smartphones-and-mobile
+* embedded-and-microcontrollers
+* iot
+* mobile-graphics-and-gaming
+* automotive
 
 {{% notice Note%}}
 Place your Learning Path in the category closest to the environment where the software runs. The tags on the [front page of the website](/) help explain the categories. Feel free to ask on GitHub if you are unsure which category best matches your Learning Path. 
@@ -27,9 +28,9 @@ You can also add a new install guide. Install guides are short descriptions prov
 
 This section creates a new Learning Path. Refer to the next section to create a new install guide.
 
-Start creating your Learning Path from the template provided using a straightforward one-line command. For example, to create a new Learning Path with the directory name `my-new-learning-path` under the `microcontrollers` category, run the following command from the root directory of this project:
+Start creating your Learning Path from the template provided using a straightforward one-line command. For example, to create a new Learning Path with the directory name `my-new-learning-path` under the `embedded-and-microcontrollers` category, run the following command from the root directory of this project:
 ```bash
-hugo new --kind learning-path learning-paths/microcontrollers/my-new-learning-path
+hugo new --kind learning-path learning-paths/embedded-and-microcontrollers/my-new-learning-path
 ```
 Result: The following markdown files are added to the `my-new-learning-path` directory:
 
@@ -39,7 +40,6 @@ Result: The following markdown files are added to the `my-new-learning-path` dir
 | _index.md             | This file contains the title, target audience, and tagging metadata for your new Learning Path. The next step of this Learning Path explains these metadata elements and how to complete them correctly. |
 | how-to-1.md       | This file contains the how-to content for the Learning Path. Create multiple how-to pages to segment stages within your Learning Path. Each `how-to-N.md` file represents another distinct stage in your learning Path. Name this file to reflect the content you are adding. |
 | example-picture.png  | (optional) Pictures and screenshots can be included in this directory to appear in your Learning Path, Images can also be referenced as web links if you prefer. |
-| _review.md            | This file contains simple questions and answers to reinforce knowledge gained from your Learning Path.    |
 | _next_steps.md        | This file contains the next recommended steps and related resources for the reader to use on completion of this Learning Path.   |
 
 ### Order the content within the Learning Path