feat: switch to just-the-docs theme for visual parity with code-quality workshop

- Replace jekyll-theme-minimal with just-the-docs remote theme
- Update Gemfile to use github-pages gem
- Add baseurl, nav_order_base, heading_anchors to _config.yml
- Exclude images/ from navigation via defaults
- Convert lab checklist to table with Duration/Level columns
- Add Workshop Schedule sections (half-day/full-day time blocks)
- Add mermaid center style to head-custom.html
- Update Getting Started section

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: emmanuelknafo

Gemfile

@@ -1,9 +1,3 @@
 source "https://rubygems.org"
-
-gem "jekyll", "~> 3.10"
-gem "jekyll-theme-minimal"
-gem "jekyll-relative-links"
-
-group :jekyll_plugins do
-  gem "jekyll-relative-links"
-end
+gem "github-pages", group: :jekyll_plugins
+gem "webrick", "~> 1.8"

_config.yml

@@ -1,17 +1,25 @@
 title: "FinOps Cost Governance Workshop"
 description: "Learn to scan Azure resources for cost governance violations using PSRule, Checkov, Cloud Custodian, and Infracost."
-theme: jekyll-theme-minimal
-plugins:
-  - jekyll-relative-links
-relative_links:
-  enabled: true
-  collections: true
+remote_theme: just-the-docs/just-the-docs
+baseurl: "/finops-scan-workshop"
+url: "https://devopsabcs-engineering.github.io"
+
 exclude:
-  - Gemfile
-  - Gemfile.lock
   - scripts/
+  - delivery/
+  - .devcontainer/
+  - node_modules/
+  - package.json
+  - package-lock.json
+  - Gemfile.lock
   - src/
   - .copilot-tracking/
-  - .github/agents/
-  - .github/prompts/
-  - .github/skills/
+
+defaults:
+  - scope:
+      path: "images"
+    values:
+      nav_exclude: true
+
+nav_order_base: 0
+heading_anchors: true

_includes/head-custom.html

@@ -1,13 +1,13 @@
 <script type="module">
   import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.esm.min.mjs';
-
-  document.querySelectorAll('pre > code.language-mermaid').forEach((codeBlock) => {
-    const pre = codeBlock.parentElement;
+  mermaid.initialize({ startOnLoad: true });
+  document.querySelectorAll('pre > code.language-mermaid').forEach(el => {
     const div = document.createElement('div');
     div.className = 'mermaid';
-    div.textContent = codeBlock.textContent;
-    pre.parentElement.replaceChild(div, pre);
+    div.textContent = el.textContent;
+    el.parentElement.replaceWith(div);
   });
-
-  mermaid.initialize({ startOnLoad: true });
 </script>
+<style>
+  .mermaid { text-align: center; }
+</style>

index.md

@@ -1,15 +1,19 @@
 ---
 layout: default
-title: "FinOps Cost Governance Workshop"
+title: Home
+nav_order: 0
+permalink: /
 ---
 
 # FinOps Cost Governance Workshop
 
+Welcome to the **FinOps Cost Governance Workshop** — a hands-on, progressive workshop that teaches you how to scan Azure infrastructure for cost governance violations using four open-source tools: PSRule, Checkov, Cloud Custodian, and Infracost.
+
+All results are normalized to [SARIF v2.1.0](https://docs.oasis-open.org/sarif/sarif/v2.1.0/sarif-v2.1.0.html) for unified reporting in GitHub Advanced Security or Azure DevOps Advanced Security.
+
 > [!NOTE]
 > This workshop is part of the [Agentic Accelerator Framework](https://github.com/devopsabcs-engineering/agentic-accelerator-framework).
 
-Learn to scan Azure infrastructure for cost governance violations using four open-source tools—PSRule, Checkov, Cloud Custodian, and Infracost—producing SARIF output for GitHub Security tab integration.
-
 ## Architecture
 
 ```mermaid
@@ -56,20 +60,66 @@ graph LR
 | Cloud Custodian | Orphans, tagging, right-sizing on live resources | Converted | Apache 2.0 |
 | Infracost | Pre-deployment cost estimates | Converted | Apache 2.0 |
 
-## Labs
+## Prerequisites
+
+- **GitHub account** with access to create repositories
+- **Azure subscription** (required for Labs 04, 05, 07; free tier works)
+- **VS Code** with the Bicep and PowerShell extensions
+- **Tools** (installed during Lab 00):
+  - Azure CLI
+  - GitHub CLI
+  - PowerShell 7+
+  - PSRule and PSRule.Rules.Azure module
+  - Checkov (`pip install checkov`)
+  - Cloud Custodian (`pip install c7n c7n-azure`)
+  - Infracost CLI
 
-Work through the labs in order. Labs 02–05 can be completed in parallel after Lab 01.
+See [Lab 00: Prerequisites](labs/lab-00-setup.md) for detailed installation instructions.
 
-- [ ] [Lab 00 — Prerequisites and Environment Setup](labs/lab-00-setup.md) _(30 min, Beginner)_
-- [ ] [Lab 01 — Explore the Demo Apps and FinOps Violations](labs/lab-01.md) _(25 min, Beginner)_
-- [ ] [Lab 02 — PSRule: Infrastructure as Code Analysis](labs/lab-02.md) _(35 min, Intermediate)_
-- [ ] [Lab 03 — Checkov: Static Policy Scanning](labs/lab-03.md) _(30 min, Intermediate)_
-- [ ] [Lab 04 — Cloud Custodian: Runtime Resource Scanning](labs/lab-04.md) _(40 min, Intermediate)_
-- [ ] [Lab 05 — Infracost: Cost Estimation and Budgeting](labs/lab-05.md) _(35 min, Intermediate)_
-- [ ] [Lab 06 — SARIF Output and GitHub Security Tab](labs/lab-06.md) _(30 min, Intermediate)_
-- [ ] [Lab 06-ADO — SARIF Output and ADO Advanced Security](labs/lab-06-ado.md) _(35 min, Intermediate)_
-- [ ] [Lab 07 — GitHub Actions Pipelines and Cost Gates](labs/lab-07.md) _(45 min, Advanced)_
-- [ ] [Lab 07-ADO — ADO YAML Pipelines and Cost Gates](labs/lab-07-ado.md) _(50 min, Advanced)_
+## Labs
+
+| # | Lab | Duration | Level |
+|---|-----|----------|-------|
+| 00 | [Prerequisites](labs/lab-00-setup.md) | 30 min | Beginner |
+| 01 | [Explore Demo Apps](labs/lab-01.md) | 25 min | Beginner |
+| 02 | [PSRule](labs/lab-02.md) | 35 min | Intermediate |
+| 03 | [Checkov](labs/lab-03.md) | 30 min | Intermediate |
+| 04 | [Cloud Custodian](labs/lab-04.md) | 40 min | Intermediate |
+| 05 | [Infracost](labs/lab-05.md) | 35 min | Intermediate |
+| 06 | [SARIF + GitHub Security Tab](labs/lab-06.md) | 30 min | Intermediate |
+| 06-ADO | [SARIF + ADO Advanced Security](labs/lab-06-ado.md) | 35 min | Intermediate |
+| 07 | [GitHub Actions + Cost Gates](labs/lab-07.md) | 45 min | Advanced |
+| 07-ADO | [ADO Pipelines + Cost Gates](labs/lab-07-ado.md) | 50 min | Advanced |
+
+## Workshop Schedule
+
+### Half-Day (3.5 hours)
+
+| Time | Activity |
+|------|----------|
+| 0:00 – 0:30 | Lab 00: Prerequisites |
+| 0:30 – 0:55 | Lab 01: Explore Demo Apps |
+| 0:55 – 1:30 | Lab 02: PSRule |
+| 1:30 – 2:00 | Lab 03: Checkov |
+| 2:00 – 2:15 | Break |
+| 2:15 – 2:45 | Lab 06: SARIF + GitHub Security Tab (or Lab 06-ADO) |
+
+### Full-Day (7 hours)
+
+| Time | Activity |
+|------|----------|
+| 0:00 – 0:30 | Lab 00: Prerequisites |
+| 0:30 – 0:55 | Lab 01: Explore Demo Apps |
+| 0:55 – 1:30 | Lab 02: PSRule |
+| 1:30 – 2:00 | Lab 03: Checkov |
+| 2:00 – 2:40 | Lab 04: Cloud Custodian |
+| 2:40 – 2:55 | Break |
+| 2:55 – 3:30 | Lab 05: Infracost |
+| 3:30 – 4:00 | Lab 06: SARIF + GitHub Security Tab |
+| 4:00 – 4:35 | Lab 06-ADO: SARIF + ADO Advanced Security |
+| 4:35 – 4:50 | Break |
+| 4:50 – 5:35 | Lab 07: GitHub Actions + Cost Gates |
+| 5:35 – 6:25 | Lab 07-ADO: ADO Pipelines + Cost Gates |
 
 ## Lab Dependency Diagram
 
@@ -110,25 +160,13 @@ graph LR
 | Full-Day (ADO) | ADO | 00–05, 06-ADO, 07-ADO | ~7.75 hours | Yes |
 | Full-Day (Dual) | Both | 00–05, 06, 06-ADO, 07, 07-ADO | ~9.25 hours | Yes |
 
-## Prerequisites
-
-- **GitHub account** with access to create repositories
-- **Azure subscription** (required for Labs 04, 05, 07; free tier works)
-- **VS Code** with the Bicep and PowerShell extensions
-- **Tools** (installed during Lab 00):
-  - Azure CLI
-  - GitHub CLI
-  - PowerShell 7+
-  - PSRule and PSRule.Rules.Azure module
-  - Checkov (`pip install checkov`)
-  - Cloud Custodian (`pip install c7n c7n-azure`)
-  - Infracost CLI
-
 ## Getting Started
 
-1. **Use this template** — Click [Use this template](https://github.com/devopsabcs-engineering/finops-scan-workshop/generate) to create your own copy.
-2. **Install prerequisites** — Follow [Lab 00](labs/lab-00-setup.md) to set up your environment.
-3. **Start scanning** — Work through the labs sequentially, beginning with [Lab 01](labs/lab-01.md).
+1. **Fork or use this template** to create your own workshop instance.
+2. Complete [Lab 00: Prerequisites](labs/lab-00-setup.md) to set up your environment.
+3. Work through the labs in order — each lab builds on the previous one.
+
+> **Tip**: This workshop is designed for GitHub Codespaces. Click **Code → Codespaces → New codespace** to get a pre-configured environment with all tools installed.
 
 ## License