Skip to content

Commit 50c9fb8

Browse files
fix: dual-render links for GitHub repo and Pages (#14)
- index.md: links without .md for Pages routing - README.md: links with .md for GitHub repo navigation - lab files: permalinks for clean URLs, cross-lab links without .md 🔧 - Generated by Copilot
1 parent 71f0c7f commit 50c9fb8

13 files changed

Lines changed: 47 additions & 35 deletions

File tree

index.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -40,18 +40,18 @@ Before starting Lab 00, ensure you have the following:
4040

4141
Work through the labs in order. Each lab builds on the previous one.
4242

43-
- [ ] [Lab 00 - Prerequisites and Environment Setup](labs/lab-00-setup.md) _(30 min, Beginner)_
44-
- [ ] [Lab 01 - Explore the Sample App](labs/lab-01.md) _(25 min, Beginner)_
45-
- [ ] [Lab 02 - Understanding Agents, Skills, and Instructions](labs/lab-02.md) _(20 min, Beginner)_
46-
- [ ] [Lab 03 - Security Scanning with Copilot Agents](labs/lab-03.md) _(40 min, Intermediate)_
47-
- [ ] [Lab 04 - Accessibility Scanning with Copilot Agents](labs/lab-04.md) _(35 min, Intermediate)_
48-
- [ ] [Lab 05 - Code Quality Analysis with Copilot Agents](labs/lab-05.md) _(35 min, Intermediate)_
49-
- [ ] [Lab 06 - Understanding SARIF Output](labs/lab-06.md) _(30 min, Intermediate)_
50-
- [ ] [Lab 07 - Setting Up GitHub Actions Pipelines](labs/lab-07.md) _(40 min, Intermediate)_
51-
- [ ] [Lab 08 - Viewing Results in GitHub Security Tab](labs/lab-08.md) _(25 min, Intermediate)_
52-
- [ ] [Lab 09 - FinOps Agents and Azure Cost Governance](labs/lab-09.md) _(45 min, Advanced)_ ⭐ Optional
53-
- [ ] [Lab 10 - Agent Remediation Workflows](labs/lab-10.md) _(45 min, Advanced)_
54-
- [ ] [Lab 11 - Creating Your Own Custom Agent](labs/lab-11.md) _(45 min, Advanced)_
43+
- [ ] [Lab 00 - Prerequisites and Environment Setup](labs/lab-00-setup) _(30 min, Beginner)_
44+
- [ ] [Lab 01 - Explore the Sample App](labs/lab-01) _(25 min, Beginner)_
45+
- [ ] [Lab 02 - Understanding Agents, Skills, and Instructions](labs/lab-02) _(20 min, Beginner)_
46+
- [ ] [Lab 03 - Security Scanning with Copilot Agents](labs/lab-03) _(40 min, Intermediate)_
47+
- [ ] [Lab 04 - Accessibility Scanning with Copilot Agents](labs/lab-04) _(35 min, Intermediate)_
48+
- [ ] [Lab 05 - Code Quality Analysis with Copilot Agents](labs/lab-05) _(35 min, Intermediate)_
49+
- [ ] [Lab 06 - Understanding SARIF Output](labs/lab-06) _(30 min, Intermediate)_
50+
- [ ] [Lab 07 - Setting Up GitHub Actions Pipelines](labs/lab-07) _(40 min, Intermediate)_
51+
- [ ] [Lab 08 - Viewing Results in GitHub Security Tab](labs/lab-08) _(25 min, Intermediate)_
52+
- [ ] [Lab 09 - FinOps Agents and Azure Cost Governance](labs/lab-09) _(45 min, Advanced)_ ⭐ Optional
53+
- [ ] [Lab 10 - Agent Remediation Workflows](labs/lab-10) _(45 min, Advanced)_
54+
- [ ] [Lab 11 - Creating Your Own Custom Agent](labs/lab-11) _(45 min, Advanced)_
5555

5656
## Delivery Tiers
5757

@@ -93,7 +93,7 @@ not block later labs.
9393
own copy.
9494
2. Clone the new repository to your local machine.
9595
3. Open the repository in VS Code.
96-
4. Start with [Lab 00 - Prerequisites and Environment Setup](labs/lab-00-setup.md).
96+
4. Start with [Lab 00 - Prerequisites and Environment Setup](labs/lab-00-setup).
9797

9898
## Credits
9999

labs/lab-00-setup.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
---
2+
permalink: /labs/lab-00-setup
23
title: "Lab 00 - Prerequisites and Environment Setup"
34
description: "Install required tools, VS Code extensions, create your workshop repository from the template, and verify GitHub Copilot Chat."
45
---
@@ -121,4 +122,4 @@ Before proceeding, verify:
121122

122123
## Next Steps
123124

124-
Proceed to [Lab 01 — Explore the Sample App](lab-01.md).
125+
Proceed to [Lab 01 — Explore the Sample App](lab-01).

labs/lab-01.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
---
2+
permalink: /labs/lab-01
23
title: "Lab 01 - Explore the Sample App"
34
description: "Navigate the workshop repository structure, identify the four agent domains, run the sample app locally, and discover intentional vulnerabilities."
45
---
@@ -9,7 +10,7 @@ description: "Navigate the workshop repository structure, identify the four agen
910
|---|---|
1011
| **Duration** | 25 minutes |
1112
| **Level** | Beginner |
12-
| **Prerequisites** | [Lab 00](lab-00-setup.md) |
13+
| **Prerequisites** | [Lab 00](lab-00-setup) |
1314

1415
## Learning Objectives
1516

@@ -112,4 +113,4 @@ Before proceeding, verify:
112113

113114
## Next Steps
114115

115-
Proceed to [Lab 02 — Understanding Agents, Skills, and Instructions](lab-02.md).
116+
Proceed to [Lab 02 — Understanding Agents, Skills, and Instructions](lab-02).

labs/lab-02.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
---
2+
permalink: /labs/lab-02
23
title: "Lab 02 - Understanding Agents, Skills, and Instructions"
34
description: "Distinguish between agents, skills, instructions, and prompts. Learn the orchestrator and detector/resolver design patterns."
45
---
@@ -9,7 +10,7 @@ description: "Distinguish between agents, skills, instructions, and prompts. Lea
910
|---|---|
1011
| **Duration** | 20 minutes |
1112
| **Level** | Beginner |
12-
| **Prerequisites** | [Lab 01](lab-01.md) |
13+
| **Prerequisites** | [Lab 01](lab-01) |
1314

1415
## Learning Objectives
1516

@@ -148,4 +149,4 @@ Before proceeding, verify:
148149

149150
## Next Steps
150151

151-
Proceed to [Lab 03](lab-03.md).
152+
Proceed to [Lab 03](lab-03).

labs/lab-03.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
---
2+
permalink: /labs/lab-03
23
title: "Lab 03 - Security Scanning with Copilot Agents"
34
description: "Run the security-reviewer, iac-security, and supply-chain-security agents to find OWASP Top 10 vulnerabilities, infrastructure misconfigurations, and dependency risks in the sample app."
45
---
@@ -9,7 +10,7 @@ description: "Run the security-reviewer, iac-security, and supply-chain-security
910
|---|---|
1011
| **Duration** | 40 minutes |
1112
| **Level** | Intermediate |
12-
| **Prerequisites** | [Lab 00](lab-00-setup.md), [Lab 01](lab-01.md), [Lab 02](lab-02.md) |
13+
| **Prerequisites** | [Lab 00](lab-00-setup), [Lab 01](lab-01), [Lab 02](lab-02) |
1314

1415
## Learning Objectives
1516

@@ -129,4 +130,4 @@ Before proceeding, verify:
129130

130131
## Next Steps
131132

132-
Proceed to [Lab 04 — Accessibility Scanning with Copilot Agents](lab-04.md).
133+
Proceed to [Lab 04 — Accessibility Scanning with Copilot Agents](lab-04).

labs/lab-04.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
---
2+
permalink: /labs/lab-04
23
title: "Lab 04 - Accessibility Scanning with Copilot Agents"
34
description: "Run the a11y-detector to find WCAG 2.2 Level AA violations, use the a11y-scan prompt for targeted scanning, and try the a11y-resolver handoff for automated fixes."
45
---
@@ -9,7 +10,7 @@ description: "Run the a11y-detector to find WCAG 2.2 Level AA violations, use th
910
|---|---|
1011
| **Duration** | 35 minutes |
1112
| **Level** | Intermediate |
12-
| **Prerequisites** | [Lab 00](lab-00-setup.md), [Lab 01](lab-01.md), [Lab 02](lab-02.md) |
13+
| **Prerequisites** | [Lab 00](lab-00-setup), [Lab 01](lab-01), [Lab 02](lab-02) |
1314

1415
## Learning Objectives
1516

@@ -119,4 +120,4 @@ Before proceeding, verify:
119120

120121
## Next Steps
121122

122-
Proceed to [Lab 05 — Code Quality Analysis with Copilot Agents](lab-05.md).
123+
Proceed to [Lab 05 — Code Quality Analysis with Copilot Agents](lab-05).

labs/lab-05.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
---
2+
permalink: /labs/lab-05
23
title: "Lab 05 - Code Quality Analysis with Copilot Agents"
34
description: "Measure test coverage, run the code-quality-detector to find quality issues, use the test-generator to create unit tests, and observe coverage improvement."
45
---
@@ -9,7 +10,7 @@ description: "Measure test coverage, run the code-quality-detector to find quali
910
|---|---|
1011
| **Duration** | 35 minutes |
1112
| **Level** | Intermediate |
12-
| **Prerequisites** | [Lab 00](lab-00-setup.md), [Lab 01](lab-01.md), [Lab 02](lab-02.md) |
13+
| **Prerequisites** | [Lab 00](lab-00-setup), [Lab 01](lab-01), [Lab 02](lab-02) |
1314

1415
## Learning Objectives
1516

@@ -128,4 +129,4 @@ Before proceeding, verify:
128129

129130
## Next Steps
130131

131-
Proceed to [Lab 06](lab-06.md).
132+
Proceed to [Lab 06](lab-06).

labs/lab-06.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
---
2+
permalink: /labs/lab-06
23
title: "Lab 06 - Understanding SARIF Output"
34
description: "Explore the SARIF v2.1.0 JSON structure, navigate findings with the SARIF Viewer extension, learn category prefixes and severity mapping, and understand how GitHub ingests SARIF results."
45
---
@@ -9,7 +10,7 @@ description: "Explore the SARIF v2.1.0 JSON structure, navigate findings with th
910
|---|---|
1011
| **Duration** | 30 minutes |
1112
| **Level** | Intermediate |
12-
| **Prerequisites** | At least one of [Lab 03](lab-03.md), [Lab 04](lab-04.md), or [Lab 05](lab-05.md) |
13+
| **Prerequisites** | At least one of [Lab 03](lab-03), [Lab 04](lab-04), or [Lab 05](lab-05) |
1314

1415
## Learning Objectives
1516

@@ -131,4 +132,4 @@ Before proceeding, verify:
131132

132133
## Next Steps
133134

134-
Proceed to [Lab 07](lab-07.md) to enable GitHub Actions workflows and trigger them with a pull request.
135+
Proceed to [Lab 07](lab-07) to enable GitHub Actions workflows and trigger them with a pull request.

labs/lab-07.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
---
2+
permalink: /labs/lab-07
23
title: "Lab 07 - Setting Up GitHub Actions Pipelines"
34
description: "Review the workshop GitHub Actions workflows, enable Actions in your repository, trigger workflows by opening a pull request, and monitor execution in the Actions tab."
45
---
@@ -9,7 +10,7 @@ description: "Review the workshop GitHub Actions workflows, enable Actions in yo
910
|---|---|
1011
| **Duration** | 40 minutes |
1112
| **Level** | Intermediate |
12-
| **Prerequisites** | [Lab 00](lab-00-setup.md) through [Lab 06](lab-06.md) |
13+
| **Prerequisites** | [Lab 00](lab-00-setup) through [Lab 06](lab-06) |
1314

1415
## Learning Objectives
1516

@@ -134,4 +135,4 @@ Before proceeding, verify:
134135

135136
## Next Steps
136137

137-
Proceed to [Lab 08](lab-08.md) to explore the uploaded SARIF results in the GitHub Security tab.
138+
Proceed to [Lab 08](lab-08) to explore the uploaded SARIF results in the GitHub Security tab.

labs/lab-08.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
---
2+
permalink: /labs/lab-08
23
title: "Lab 08 - Viewing Results in GitHub Security Tab"
34
description: "Navigate the GitHub Security tab, filter Code Scanning alerts by tool and severity, view finding details with source code context, explore Dependabot alerts, and manage alert lifecycle."
45
---
@@ -9,7 +10,7 @@ description: "Navigate the GitHub Security tab, filter Code Scanning alerts by t
910
|---|---|
1011
| **Duration** | 25 minutes |
1112
| **Level** | Intermediate |
12-
| **Prerequisites** | [Lab 07](lab-07.md) (workflows completed) |
13+
| **Prerequisites** | [Lab 07](lab-07) (workflows completed) |
1314

1415
## Learning Objectives
1516

@@ -126,4 +127,4 @@ Before proceeding, verify:
126127

127128
## Next Steps
128129

129-
Proceed to [Lab 09](lab-09.md) to explore FinOps governance and cost analysis with Copilot agents.
130+
Proceed to [Lab 09](lab-09) to explore FinOps governance and cost analysis with Copilot agents.

0 commit comments

Comments
 (0)