Merge branch 'main' into learning-path/litespark-inference

Author: jasonrandrews

.github/skills/learning-path-structure-review/SKILL.md

@@ -10,7 +10,7 @@ Use this skill when a Learning Path needs a structural review. Focus on whether
 ## Workflow
 
 1. Identify the Learning Path directory and read the relevant Markdown files together.
-2. State the owned developer task in one sentence. If the task is unclear, too broad, or split across unrelated goals, flag it.
+2. Summarize the developer task owned by LP in one sentence. If the task is unclear, too broad, or split across unrelated goals, flag it.
 3. Check the required file shape:
    - The Learning Path has an `_index.md` file.
    - The Learning Path has an `_next-steps.md` file.

.github/skills/markdown-component-edit/references/component-patterns.md

@@ -86,4 +86,28 @@ Rules:
 - Keep each tab roughly comparable in length and detail.
 - Avoid hiding critical sequential instructions inside tabs unless the user chooses one path.
 
+## Mathematical expressions
 
+Use `\(...\)` to display a mathematical expression inline.
+
+For example:
+
+```md
+\(\sqrt{re^2 + im^2}\)
+```
+
+Use `$$...$$` or `\[...\]` to display a mathematical expression in a block.
+
+For example:
+
+```md
+$$re_{new} = re_z^2 - im_z^2 + re_c$$
+```
+
+or
+
+```md
+\[
+re_{new} = re_z^2 - im_z^2 + re_c
+\]
+```

.github/skills/seo-geo-aeo-review/SKILL.md

@@ -23,9 +23,11 @@ For focused front matter `description` edits only, use `.github/skills/metadata-
 
 ## Workflow
 
+On any given page:
+
 1. Identify the target content type and target developer intent. 
-2. Read the title, front matter description, headings, introduction, prerequisites, main task flow, validation, conclusion, and further reading. If you've previously read a page, use context and don't re-read it unless there's a change since the last read. 
-3. State the page's owned task in one sentence. If the task is unclear or too broad, flag it.
+2. Read the title, front matter description, headings, introduction, prerequisites, main task flow, validation, conclusion, and further reading. If you've previously read the page, use context and don't re-read it unless asked to. 
+3. Summarize the page's owned task in one sentence. If the task is unclear or too broad, flag it.
 4. Review SEO signals:
    - The title is task-led and includes the main technology, platform, or tool.
    - The `description` is one concise sentence that states the task, context, and outcome.

.github/skills/writing-style-review/SKILL.md

@@ -10,16 +10,16 @@ Use this skill for granular prose, voice, readability, terminology, and style re
 ## Workflow
 
 1. Identify the target file, section, or selected text.
-2. Read surrounding context so style edits preserve the author's intent and the technical flow. If you've previously read the page, use context and don't re-read it unless there's a change since the last read. 
+2. Read surrounding context so style edits preserve the author's intent and the technical flow. If you've previously read the page, use context and don't re-read it unless asked to. 
 3. Review the target against the guidelines defined in this skill.
 4. Depending on request type, do the following:
-  - For review requests, report high-impact style issues by file and line when possible. 
+  - For review requests, report style issues by file and line when possible, ordered by severity. 
   - For edit requests, make focused rewrites, then re-open changed sections to check Markdown, shortcodes, links, and code fences.
 
 ## Voice and tone
 
 - Use second person: `you` and `your` for Learning Path summaries, Learning Path content, install guide content, answers to FAQs, and metadata descriptions. Avoid first person for these content types.
-- Use first person: `I` and `we` for FAQs.
+- Use first person: `I` for FAQ questions only.
 - Use active voice.
 - Use present tense for descriptions.
 - Use imperative mood for commands.

.github/workflows/deploy.yml

@@ -68,7 +68,12 @@ jobs:
 
       # Builds arm-software-developer repo
       - name: Build
-        run: hugo --minify
+        run: |
+          if [ "${{ inputs.target }}" = "dev" ]; then
+            hugo --minify --config config.toml,config.internal.toml
+          else
+            hugo --minify --config config.toml,config.production.toml
+          fi
         env:
           HUGO_LLM_API: ${{ secrets.HUGO_LLM_API }}
           HUGO_RAG_API: ${{ secrets.HUGO_RAG_API }}

.wordlist.txt

@@ -6450,3 +6450,159 @@ boundedness
 cbf
 dda
 efe
+ArgumentParser
+ArmCcaBootSync
+ArmVirtPkg
+BeautifulSoup
+BootSync
+Chadha
+Cryptsetup
+CycloneDX
+Deduplicate
+GCM
+GenPd
+Grainge
+HKDF
+IDF
+ImageSharp
+InitRD
+Jaidev
+LUKS
+MLA
+Makefile’s
+Minecraft
+Mojang
+Neary
+NextToken
+PgBouncer
+RPV
+ReadyToRun
+SBOM
+SDK’s
+SecureBoot
+Serper
+SixLabors
+VMM
+aac
+aaff
+abad
+abb
+adcee
+aea
+aece
+aeffccb
+afb
+afbfc
+afcd
+afcebb
+afd
+analysed
+argparse
+autovacuum
+bac
+bca
+bcd
+bdbf
+bdde
+bdf
+bedc
+bfa
+bfb
+bootaa
+burstier
+cacd
+cbfa
+cefd
+cfce
+cfd
+cff
+cffe
+citext
+cryptomount
+cryptroot
+daadf
+dbbf
+dbbff
+dbe
+dcd
+dcdc
+dced
+ddbaed
+ddc
+debf
+deduplicates
+deduplicating
+deeec
+defc
+devtmpfs
+dfab
+dfd
+eaa
+eabda
+ead
+eaec
+ebbb
+ebbd
+ecd
+edd
+edf
+efa
+efbecf
+efecb
+efi
+Makefile’s
+SDK’s
+amazonlinux
+efisecret
+efivar
+efivarfs
+efivars
+fac
+facd
+faef
+fba
+fbbc
+fbca
+fbfaff
+fcc
+fcd
+fdee
+fec
+filedata
+hd
+initrd
+kFjEUDJexI
+keyslot
+keyslots
+kustomize
+makecache
+noarch
+nopCommerce
+nopCommerce's
+nopSolutions
+nopcommerce
+nvoid
+pooler
+retargeting
+rhel
+rstrip
+searchtermautocomplete
+securityfs
+serper
+shm
+sixlabors
+sles
+subagents
+svmla
+unexecuted
+vacc
+vaddvq
+vcn
+vfmaq
+vw
+vx
+wal
+whitespace
+xxxxxxxx
+Makefile’s
+SDK’s

assets/contributors.csv

@@ -2,6 +2,7 @@ author,company,github,linkedin,twitter,website
 Jason Andrews,Arm,jasonrandrews,jason-andrews-7b05a8,,
 Doug Anson,Arm,DougAnsonAustinTx,douganson,,
 Pareena Verma,Arm,pareenaverma,pareena-verma-7853607,,
+Jaidev Singh Chadha,Arm,jaidev17,jaidevsinghchadha,,
 Ronan Synnott,Arm,,ronansynnott,,
 Florent Lebeau,Arm,,,,
 Brenda Strech,Remote.It,bstrech,bstrech,@remote_it,www.remote.it
@@ -88,6 +89,7 @@ Geremy Cohen,Arm,geremyCohen,geremyinanutshell,,
 Barbara Corriero,Arm,,,,
 Nina Drozd,Arm,NinaARM,ninadrozd,,
 Jun He,Arm,JunHe77,jun-he-91969822,,
+Henry Wang,Arm,MrXinWang,xin-wang-930b4b141,,
 Gian Marco Iodice,Arm,,,,
 Aude Vuilliomenet,Arm,,,,
 Andrew Kilroy,Arm,,,,
@@ -129,6 +131,7 @@ Anupras Mohapatra,Arm,,,,
 Tomas Agustin Gonzalez Orlando,Arm,tgonzalezorlandoarm,tgorlando,,
 Jai Adam Schrem,Arm,jai-adam-schrem,jai-adam-s-395bb1233,,
 Steve Jordahl,Rafay,,,,
-Nii Osae Osae Dade,Mindbeam,StarkOsae,,,
-Tony Morri,Mindbeam,tonymindbeamai,,,
-Sayandip Pal,Mindbeam,sayandip-pal,,,
+Nii Osae Osae Dade,Mindbeam,StarkOsae,,,
+Tony Morri,Mindbeam,tonymindbeamai,,,
+Sayandip Pal,Mindbeam,sayandip-pal,,,
+Dave Neary,Ampere,,,,

assets/css/content-pages.css

@@ -32,7 +32,7 @@
     margin-top: -1px !important;
 }
 html[theme='dark'] .tab-row {
-    background-color: var(--arm-black); /* rgba(163, 168, 174,1); #2A2B2D; */
+    background-color: var(--content-page-surface);
 }
 
 .tab-row.active {
@@ -72,7 +72,7 @@ html[theme='dark'] .tab-row.active {
 
 html[theme='dark'] .tab-right-card {
     border-color: rgba(163, 168, 174,0.25); /* #A3A8AE at 25% transparency */
-    background-color: rgb(23,25,27);  /* CLOSE to this, but hard coded as they are close to background gradient var(--arm-color-base) at 75% transparency */
+    background-color: var(--content-page-surface);
 }
 html[theme='dark'] .tab-right-card.active {
     border-color: var(--arm-light-blue);
@@ -88,20 +88,6 @@ html[theme='dark'] .tab-right-card > h6 {
     line-height: 1.2;
 }
 
-/* Force a 2-line clamp for masthead title */
-ads-masthead #ads-masthead-title {
-  line-height: 1.2;
-  padding-bottom: 6px;
-  box-sizing: border-box;
-  max-height: calc(1.2em * 2 + 8px); /* dyncamically calculate height depending on length of title */
-  overflow: hidden;
-  display: -webkit-box;
-  -webkit-line-clamp: 2;
-  -webkit-box-orient: vertical;
-  white-space: normal;
-}
-
-
 /* hover effects */
 a:hover {
     text-decoration: none; }
@@ -155,7 +141,7 @@ div.github-div {
 
 html[theme='dark'] div.github-div {
     border-color: rgba(163, 168, 174,0.25); /* #A3A8AE at 25% transparency */
-    background-color: rgb(23,25,27);;  /* CLOSE to this, but not due to close to gradient background. var(--arm-color-base) at 75% transparency */
+    background-color: var(--content-page-surface);
 
 }
 
@@ -185,12 +171,12 @@ ads-card.multi-install-card {
     --ads-card-box-shadow-hover: 0 3px 6px 1px rgba(0,0,0,0.16);  /* 0 1px 3px 3px rgba(0,0,0,0.25); */
 } 
 html[theme='dark'] ads-card.multi-install-card {
-    --ads-card-background-color: var(--arm-color-base);
+    --ads-card-background-color: var(--ads-ui-ink-80);
     --ads-card-border-color: #000000;
     /*--ads-card-box-shadow:  0 3px 12px rgba(0, 0, 0, 0.5);*/
 
     /* hover state */
-    --ads-card-background-color-hover: var(--arm-color-base);
+    --ads-card-background-color-hover: var(--ads-ui-ink-80);
     --ads-card-border-color-hover: transparent;
     /*--ads-card-box-shadow-hover:  0 3px 12px rgba(0, 0, 0, 0.5);*/
 

assets/css/content.css

@@ -16,6 +16,11 @@
 
 
 /* Box around content (learning paths and tools) */
+html[theme="dark"] #main {
+    --content-page-surface: var(--ads-ui-ink-90);
+    background-color: var(--ads-ui-ink-100);
+}
+
 div.content-box {
     padding-left: 16px;
     padding-right: 16px;
@@ -28,7 +33,7 @@ div.content-box {
     border-radius: 5px;
 
     border-color: rgba(163, 168, 174,0.25); /* #A3A8AE at 25% transparency */
-    background-color: rgba(31,32,35,0.75);  /* var(--arm-color-base) at 75% transparency */
+    background-color: var(--content-page-surface);
 }
 html[theme="light"] div.content-box {
     background-color: white;

assets/css/context-tables.css

@@ -5,6 +5,12 @@ td.nowrap {
     white-space: nowrap;
 }
 
+.learning-path-metadata .td-metadata-key,
+.learning-path-metadata .td-metadata-value {
+    border-top: 0;
+    border-bottom: 0;
+}
+
 .td-metadata-key {
     height: fit-content;
     padding: 0px;