Skip to content

Commit 89ea0ac

Browse files
authored
Merge pull request #3374 from chrismoroney/STESOL-345
summary and faqs ai feature
2 parents 5ecbdf7 + 5d764e1 commit 89ea0ac

462 files changed

Lines changed: 5585 additions & 927 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

archetypes/learning-path/_index.md

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,16 @@ prerequisites:
1515

1616
author: PLACEHOLDER NAME
1717

18+
# New Learning Paths are opted in for the next manual generated summary/FAQ run.
19+
# The generator resets this to false after a successful write.
20+
generate_summary_faq: true
21+
22+
# Optional one-shot controls: set either field to true to regenerate just that
23+
# generated section the next time the summary/FAQ tool runs. The tool resets
24+
# them to false after a successful write.
25+
rerun_summary: false
26+
rerun_faqs: false
27+
1828
### Tags
1929
skilllevels: PLACEHOLDER SKILLLEVEL
2030
subjects: PLACEHOLDER SUBJECT
@@ -27,8 +37,6 @@ tools_software_languages:
2737
operatingsystems:
2838
- PLACEHOLDER OS G
2939

30-
31-
3240
further_reading:
3341
- resource:
3442
title: PLACEHOLDER MANUAL
@@ -43,8 +51,6 @@ further_reading:
4351
link: PLACEHOLDER GENERAL WEBSITE LINK
4452
type: website
4553

46-
47-
4854
### FIXED, DO NOT MODIFY
4955
# ================================================================================
5056
weight: 1 # _index.md always has weight of 1 to order correctly

assets/css/content-pages.css

Lines changed: 74 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -261,6 +261,80 @@ html[theme='dark'] .incorrect-explain {color: #e86868} /* 27% lighter than arm's
261261
color: var(--arm-green);
262262
}
263263

264+
265+
266+
/* Generated AI-assisted summary/FAQ block
267+
*******************************************************************/
268+
.generated-summary-faq__heading {
269+
align-items: center;
270+
display: flex;
271+
flex-wrap: wrap;
272+
column-gap: 12px;
273+
margin-bottom: 16px;
274+
row-gap: 8px;
275+
}
276+
277+
.generated-summary-faq__heading h3 {
278+
line-height: 1.1;
279+
margin: 0;
280+
}
281+
282+
.generated-summary-faq__assist {
283+
align-items: center;
284+
display: inline-flex;
285+
gap: 6px;
286+
}
287+
288+
.generated-summary-faq__assist ads-modal {
289+
display: inline-flex;
290+
}
291+
292+
ads-tag.generated-summary-faq__ai-tag {
293+
--ads-tag-background-color: transparent;
294+
--ads-tag-background-color-hover: transparent;
295+
--ads-tag-border-color: 1px solid var(--arm-web-safe-blue);
296+
--ads-tag-border-color-hover: 1px solid var(--arm-green);
297+
--ads-tag-color: var(--arm-web-safe-blue);
298+
--ads-tag-color-hover: var(--arm-green);
299+
}
300+
301+
html[theme='dark'] ads-tag.generated-summary-faq__ai-tag {
302+
--ads-tag-border-color: 1px solid var(--arm-light-blue);
303+
--ads-tag-border-color-hover: 1px solid var(--arm-green);
304+
--ads-tag-color: var(--arm-light-blue);
305+
--ads-tag-color-hover: var(--arm-green);
306+
}
307+
308+
ads-button.generated-summary-faq__info {
309+
--ads-button-color: var(--arm-web-safe-blue);
310+
--ads-button-color-hover: var(--arm-green);
311+
--ads-button-border-color: var(--arm-web-safe-blue);
312+
--ads-button-border-color-hover: var(--arm-green);
313+
}
314+
315+
html[theme='dark'] ads-button.generated-summary-faq__info {
316+
--ads-button-color: var(--arm-light-blue);
317+
--ads-button-color-hover: var(--arm-green);
318+
--ads-button-border-color: var(--arm-light-blue);
319+
--ads-button-border-color-hover: var(--arm-green);
320+
}
321+
322+
ads-expansion-panel.generated-summary-faq__panel {
323+
--ads-expansion-panel-border-color: var(--arm-light-grey);
324+
--ads-expansion-panel-content-background-color: transparent;
325+
--ads-expansion-panel-toggle-background-color: transparent;
326+
--ads-expansion-panel-toggle-background-color-hover: transparent;
327+
--ads-expansion-panel-toggle-icon-color-hover: var(--arm-green);
328+
}
329+
330+
html[theme='dark'] ads-expansion-panel.generated-summary-faq__panel {
331+
--ads-expansion-panel-border-color: rgba(163, 168, 174, 0.25);
332+
--ads-expansion-panel-content-background-color: transparent;
333+
--ads-expansion-panel-toggle-background-color: transparent;
334+
--ads-expansion-panel-toggle-background-color-hover: transparent;
335+
--ads-expansion-panel-toggle-icon-color-hover: var(--arm-green);
336+
}
337+
264338
.share-icon {
265339
width: 36px;
266340
height: 36px;

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

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -15,9 +15,12 @@ prerequisites:
1515
draft: true
1616
cascade:
1717
draft: true
18-
1918
author: Jason Andrews
2019

20+
generate_summary_faq: true
21+
rerun_summary: false
22+
rerun_faqs: false
23+
2124
### Tags
2225
skilllevels: Introductory
2326
subjects: Performance and Architecture
@@ -29,7 +32,6 @@ operatingsystems:
2932
- RTOS
3033
tools_software_languages:
3134

32-
3335
further_reading:
3436
- resource:
3537
title: Raspberry Pi Pico
@@ -40,7 +42,6 @@ further_reading:
4042
link: https://microbit.org/
4143
type: website
4244

43-
4445
weight: 1
4546
layout: "learningpathall" # All files under learning paths have this same wrapper
4647
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

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,10 @@ prerequisites:
1717

1818
author: Odin Shen
1919

20+
generate_summary_faq: true
21+
rerun_summary: false
22+
rerun_faqs: false
23+
2024
### Tags
2125
skilllevels: Introductory
2226
subjects: Containers and Virtualization
@@ -29,7 +33,6 @@ tools_software_languages:
2933
operatingsystems:
3034
- Linux
3135

32-
3336
further_reading:
3437
- resource:
3538
title: Autoware OpenAD Kit demo project
@@ -48,11 +51,10 @@ further_reading:
4851
link: https://docs.ros.org/en/humble/
4952
type: documentation
5053

51-
52-
5354
### FIXED, DO NOT MODIFY
5455
# ================================================================================
5556
weight: 1 # _index.md always has weight of 1 to order correctly
5657
layout: "learningpathall" # All files under learning paths have this same wrapper
5758
learning_path_main_page: "yes" # This should be surfaced when looking for related content. Only set for _index.md of learning path content.
5859
---
60+

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

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,10 @@ author:
2020
- Odin Shen
2121
- Julien Jayat
2222

23+
generate_summary_faq: true
24+
rerun_summary: false
25+
rerun_faqs: false
26+
2327
### Tags
2428
skilllevels: Advanced
2529
subjects: Containers and Virtualization
@@ -66,12 +70,11 @@ further_reading:
6670
title: Eclipse Cyclone DDS
6771
link: https://github.com/eclipse-cyclonedds/cyclonedds
6872
type: documentation
69-
70-
7173

7274
### FIXED, DO NOT MODIFY
7375
# ================================================================================
7476
weight: 1 # _index.md always has weight of 1 to order correctly
7577
layout: "learningpathall" # All files under learning paths have this same wrapper
7678
learning_path_main_page: "yes" # This should be surfaced when looking for related content. Only set for _index.md of learning path content.
7779
---
80+

content/learning-paths/automotive/system76-auto/_index.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,10 @@ prerequisites:
1616

1717
author: Jason Andrews
1818

19+
generate_summary_faq: true
20+
rerun_summary: false
21+
rerun_faqs: false
22+
1923
### Tags
2024
skilllevels: Introductory
2125
subjects: Containers and Virtualization
@@ -39,10 +43,10 @@ further_reading:
3943
link: https://parsec.community/
4044
type: documentation
4145

42-
4346
### FIXED, DO NOT MODIFY
4447
# ================================================================================
4548
weight: 1 # _index.md always has weight of 1 to order correctly
4649
layout: "learningpathall" # All files under learning paths have this same wrapper
4750
learning_path_main_page: "yes" # This should be surfaced when looking for related content. Only set for _index.md of learning path content.
4851
---
52+

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

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,10 @@ prerequisites:
2020

2121
author: Ronan Synnott
2222

23+
generate_summary_faq: true
24+
rerun_summary: false
25+
rerun_faqs: false
26+
2327
### Tags
2428
skilllevels: Introductory
2529
subjects: Performance and Architecture
@@ -43,10 +47,10 @@ further_reading:
4347
link: https://developer.arm.com/Tools%20and%20Software/Arm%20Development%20Studio
4448
type: website
4549

46-
4750
### FIXED, DO NOT MODIFY
4851
# ================================================================================
4952
weight: 1 # _index.md always has weight of 1 to order correctly
5053
layout: "learningpathall" # All files under learning paths have this same wrapper
5154
learning_path_main_page: "yes" # This should be surfaced when looking for related content. Only set for _index.md of learning path content.
5255
---
56+

content/learning-paths/cross-platform/_example-learning-path/_index.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,10 @@ prerequisites:
1818

1919
author: Zach Lasiuk
2020

21+
generate_summary_faq: true
22+
rerun_summary: false
23+
rerun_faqs: false
24+
2125
### Tags
2226
skilllevels: Introductory
2327
subjects:
@@ -27,17 +31,16 @@ operatingsystems:
2731
tools_software_languages:
2832
- Hugo
2933

30-
3134
further_reading:
3235
- resource:
3336
title: GitHub Project Repository
3437
link: https://github.com/ArmDeveloperEcosystem/arm-learning-paths
3538
type: website
3639

37-
3840
### FIXED, DO NOT MODIFY
3941
# ================================================================================
4042
weight: 1 # _index.md always has weight of 1 to order correctly
4143
layout: "learningpathall" # All files under learning paths have this same wrapper
4244
learning_path_main_page: "yes" # This should be surfaced when looking for related content. Only set for _index.md of learning path content.
4345
---
46+

content/learning-paths/cross-platform/adler32/_index.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,10 @@ prerequisites:
1616

1717
author: Jason Andrews
1818

19+
generate_summary_faq: true
20+
rerun_summary: false
21+
rerun_faqs: false
22+
1923
### Tags
2024
skilllevels: Introductory
2125
subjects: Performance and Architecture
@@ -34,7 +38,6 @@ shared_between:
3438
- laptops-and-desktops
3539
- mobile-graphics-and-gaming
3640

37-
3841
further_reading:
3942
- resource:
4043
title: Arm C Language Extensions
@@ -49,10 +52,10 @@ further_reading:
4952
link: https://developer.arm.com/documentation/den0018/a
5053
type: Documentation
5154

52-
5355
### FIXED, DO NOT MODIFY
5456
# ================================================================================
5557
weight: 1 # _index.md always has weight of 1 to order correctly
5658
layout: "learningpathall" # All files under learning paths have this same wrapper
5759
learning_path_main_page: "yes" # This should be surfaced when looking for related content. Only set for _index.md of learning path content.
5860
---
61+

content/learning-paths/cross-platform/automate-mcp-with-testcontainers/_index.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,10 @@ prerequisites:
1919

2020
author: Neethu Elizabeth Simon
2121

22+
generate_summary_faq: true
23+
rerun_summary: false
24+
rerun_faqs: false
25+
2226
### Tags
2327
skilllevels: Introductory
2428
subjects: CI-CD
@@ -60,10 +64,10 @@ further_reading:
6064
link: https://docs.pytest.org/
6165
type: documentation
6266

63-
6467
### FIXED, DO NOT MODIFY
6568
# ================================================================================
6669
weight: 1 # _index.md always has weight of 1 to order correctly
6770
layout: "learningpathall" # All files under learning paths have this same wrapper
6871
learning_path_main_page: "yes" # This should be surfaced when looking for related content. Only set for _index.md of learning path content.
6972
---
73+

0 commit comments

Comments
 (0)