summary and faqs ai feature

archetypes/learning-path/_index.md

@@ -15,6 +15,16 @@ prerequisites:
 
 author: PLACEHOLDER NAME
 
+# New Learning Paths are opted in for the next manual generated summary/FAQ run.
+# The generator resets this to false after a successful write.
+generate_summary_faq: true
+
+# Optional one-shot controls: set either field to true to regenerate just that
+# generated section the next time the summary/FAQ tool runs. The tool resets
+# them to false after a successful write.
+rerun_summary: false
+rerun_faqs: false
+
 ### Tags
 skilllevels: PLACEHOLDER SKILLLEVEL
 subjects: PLACEHOLDER SUBJECT
@@ -27,8 +37,6 @@ tools_software_languages:
 operatingsystems:
     - PLACEHOLDER OS G
 
-
-
 further_reading:
     - resource:
         title: PLACEHOLDER MANUAL 
@@ -43,8 +51,6 @@ further_reading:
         link: PLACEHOLDER GENERAL WEBSITE LINK
         type: website
 
-
-
 ### FIXED, DO NOT MODIFY
 # ================================================================================
 weight: 1                       # _index.md always has weight of 1 to order correctly

assets/css/content-pages.css

@@ -261,6 +261,80 @@ html[theme='dark'] .incorrect-explain {color: #e86868} /* 27% lighter than arm's
     color: var(--arm-green);
 }
 
+
+
+/* Generated AI-assisted summary/FAQ block
+*******************************************************************/
+.generated-summary-faq__heading {
+    align-items: center;
+    display: flex;
+    flex-wrap: wrap;
+    column-gap: 12px;
+    margin-bottom: 16px;
+    row-gap: 8px;
+}
+
+.generated-summary-faq__heading h3 {
+    line-height: 1.1;
+    margin: 0;
+}
+
+.generated-summary-faq__assist {
+    align-items: center;
+    display: inline-flex;
+    gap: 6px;
+}
+
+.generated-summary-faq__assist ads-modal {
+    display: inline-flex;
+}
+
+ads-tag.generated-summary-faq__ai-tag {
+    --ads-tag-background-color: transparent;
+    --ads-tag-background-color-hover: transparent;
+    --ads-tag-border-color: 1px solid var(--arm-web-safe-blue);
+    --ads-tag-border-color-hover: 1px solid var(--arm-green);
+    --ads-tag-color: var(--arm-web-safe-blue);
+    --ads-tag-color-hover: var(--arm-green);
+}
+
+html[theme='dark'] ads-tag.generated-summary-faq__ai-tag {
+    --ads-tag-border-color: 1px solid var(--arm-light-blue);
+    --ads-tag-border-color-hover: 1px solid var(--arm-green);
+    --ads-tag-color: var(--arm-light-blue);
+    --ads-tag-color-hover: var(--arm-green);
+}
+
+ads-button.generated-summary-faq__info {
+    --ads-button-color: var(--arm-web-safe-blue);
+    --ads-button-color-hover: var(--arm-green);
+    --ads-button-border-color: var(--arm-web-safe-blue);
+    --ads-button-border-color-hover: var(--arm-green);
+}
+
+html[theme='dark'] ads-button.generated-summary-faq__info {
+    --ads-button-color: var(--arm-light-blue);
+    --ads-button-color-hover: var(--arm-green);
+    --ads-button-border-color: var(--arm-light-blue);
+    --ads-button-border-color-hover: var(--arm-green);
+}
+
+ads-expansion-panel.generated-summary-faq__panel {
+    --ads-expansion-panel-border-color: var(--arm-light-grey);
+    --ads-expansion-panel-content-background-color: transparent;
+    --ads-expansion-panel-toggle-background-color: transparent;
+    --ads-expansion-panel-toggle-background-color-hover: transparent;
+    --ads-expansion-panel-toggle-icon-color-hover: var(--arm-green);
+}
+
+html[theme='dark'] ads-expansion-panel.generated-summary-faq__panel {
+    --ads-expansion-panel-border-color: rgba(163, 168, 174, 0.25);
+    --ads-expansion-panel-content-background-color: transparent;
+    --ads-expansion-panel-toggle-background-color: transparent;
+    --ads-expansion-panel-toggle-background-color-hover: transparent;
+    --ads-expansion-panel-toggle-icon-color-hover: var(--arm-green);
+}
+
 .share-icon {
     width: 36px;
     height: 36px;

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

@@ -15,9 +15,12 @@ prerequisites:
 draft: true
 cascade:
     draft: true
-
 author: Jason Andrews
 
+generate_summary_faq: true
+rerun_summary: false
+rerun_faqs: false
+
 ### Tags
 skilllevels: Introductory
 subjects: Performance and Architecture
@@ -29,7 +32,6 @@ operatingsystems:
     - RTOS
 tools_software_languages:
 
-
 further_reading:
     - resource:
         title: Raspberry Pi Pico
@@ -40,7 +42,6 @@ further_reading:
         link: https://microbit.org/
         type: website
 
-
 weight: 1
 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/automotive/openadkit1_container/_index.md

@@ -17,6 +17,10 @@ prerequisites:
 
 author: Odin Shen
 
+generate_summary_faq: true
+rerun_summary: false
+rerun_faqs: false
+
 ### Tags
 skilllevels: Introductory
 subjects: Containers and Virtualization
@@ -29,7 +33,6 @@ tools_software_languages:
 operatingsystems:
     - Linux
 
-
 further_reading:
     - resource:
         title: Autoware OpenAD Kit demo project
@@ -48,11 +51,10 @@ further_reading:
         link: https://docs.ros.org/en/humble/
         type: documentation
 
-
-
 ### 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/automotive/openadkit2_safetyisolation/_index.md

@@ -20,6 +20,10 @@ author:
     - Odin Shen
     - Julien Jayat
 
+generate_summary_faq: true
+rerun_summary: false
+rerun_faqs: false
+
 ### Tags
 skilllevels: Advanced
 subjects: Containers and Virtualization
@@ -66,12 +70,11 @@ further_reading:
         title: Eclipse Cyclone DDS 
         link: https://github.com/eclipse-cyclonedds/cyclonedds
         type: documentation
-
-
 
 ### 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/automotive/system76-auto/_index.md

@@ -16,6 +16,10 @@ prerequisites:
 
 author: Jason Andrews
 
+generate_summary_faq: true
+rerun_summary: false
+rerun_faqs: false
+
 ### Tags
 skilllevels: Introductory
 subjects: Containers and Virtualization
@@ -39,10 +43,10 @@ further_reading:
         link: https://parsec.community/
         type: documentation
 
-
 ### 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/automotive/zenacssdebug/_index.md

@@ -20,6 +20,10 @@ prerequisites:
 
 author: Ronan Synnott
 
+generate_summary_faq: true
+rerun_summary: false
+rerun_faqs: false
+
 ### Tags
 skilllevels: Introductory
 subjects: Performance and Architecture
@@ -43,10 +47,10 @@ further_reading:
       link: https://developer.arm.com/Tools%20and%20Software/Arm%20Development%20Studio
       type: website
 
-
 ### 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/cross-platform/_example-learning-path/_index.md

@@ -18,6 +18,10 @@ prerequisites:
 
 author: Zach Lasiuk
 
+generate_summary_faq: true
+rerun_summary: false
+rerun_faqs: false
+
 ### Tags
 skilllevels: Introductory
 subjects: 
@@ -27,17 +31,16 @@ operatingsystems:
 tools_software_languages:
     - Hugo
 
-
 further_reading:
     - resource:
         title: GitHub Project Repository
         link: https://github.com/ArmDeveloperEcosystem/arm-learning-paths
         type: website
 
-
 ### 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/cross-platform/adler32/_index.md

@@ -16,6 +16,10 @@ prerequisites:
 
 author: Jason Andrews
 
+generate_summary_faq: true
+rerun_summary: false
+rerun_faqs: false
+
 ### Tags
 skilllevels: Introductory
 subjects: Performance and Architecture
@@ -34,7 +38,6 @@ shared_between:
     - laptops-and-desktops
     - mobile-graphics-and-gaming
 
-
 further_reading:
     - resource:
         title: Arm C Language Extensions
@@ -49,10 +52,10 @@ further_reading:
         link: https://developer.arm.com/documentation/den0018/a
         type: Documentation
 
-
 ### 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/cross-platform/automate-mcp-with-testcontainers/_index.md

@@ -19,6 +19,10 @@ prerequisites:
 
 author: Neethu Elizabeth Simon
 
+generate_summary_faq: true
+rerun_summary: false
+rerun_faqs: false
+
 ### Tags
 skilllevels: Introductory
 subjects: CI-CD
@@ -60,10 +64,10 @@ further_reading:
         link: https://docs.pytest.org/
         type: documentation
 
-
 ### 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/cross-platform/avh_cicd/_index.md

@@ -16,6 +16,10 @@ prerequisites:
 
 author: Pareena Verma
 
+generate_summary_faq: true
+rerun_summary: false
+rerun_faqs: false
+
 ### Tags
 skilllevels: Introductory
 subjects: CI-CD
@@ -42,10 +46,10 @@ further_reading:
         link: https://arm-software.github.io/AVH/main/examples/html/GetStarted.html
         type: documentation
 
-
 ### 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/cross-platform/avh_cicd2/_index.md

@@ -17,6 +17,10 @@ prerequisites:
 
 author: Pareena Verma
 
+generate_summary_faq: true
+rerun_summary: false
+rerun_faqs: false
+
 ##### Tags
 skilllevels: Advanced
 subjects: CI-CD
@@ -43,11 +47,10 @@ further_reading:
         link: https://arm-software.github.io/AVH/main/examples/html/GetStarted.html
         type: documentation
 
-
-
 ### 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.
 ---
+