Skip to content

Commit 02f6bc5

Browse files
fix: use Jekyll link tags with baseurl for all content links
Relative paths like (digital-sovereignty) were resolving to domain root instead of /microsoft-sovereign-cloud-brain-trek/level-100/digital-sovereignty/ Changed from: [text](file) to: [text]({{ site.baseurl }}{% link level-100/file.md %}) This ensures Jekyll generates full URLs with the baseurl prefix, matching how navigation links work. Fixed 65 links across 3 README files.
1 parent 0eaf2e8 commit 02f6bc5

4 files changed

Lines changed: 207 additions & 65 deletions

File tree

docs/level-100/README.md

Lines changed: 28 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -60,16 +60,16 @@ Before starting Level 100, ensure you have:
6060
**Duration:** 1-2 hours
6161

6262
📚 **Main Content:**
63-
- [Digital Sovereignty Overview](digital-sovereignty) - Core concepts, principles, and customer scenarios
63+
- [Digital Sovereignty Overview]({{ site.baseurl }}{% link level-100/digital-sovereignty.md %}) - Core concepts, principles, and customer scenarios
6464

6565
**Deep Dive Topics:**
66-
- [Microsoft's European Digital Commitments](european-commitments) - The 6 commitments and EU Data Boundary
67-
- [Regulatory Requirements Overview](regulatory-overview) - GDPR, FedRAMP, HIPAA, PCI DSS, ITAR
68-
- [Data Residency vs. Sovereignty](data-residency-concepts) - Definitions and Azure implementation
69-
- [Operational Sovereignty](operational-sovereignty) - Control plane concepts and Azure Local modes
66+
- [Microsoft's European Digital Commitments]({{ site.baseurl }}{% link level-100/european-commitments.md %}) - The 6 commitments and EU Data Boundary
67+
- [Regulatory Requirements Overview]({{ site.baseurl }}{% link level-100/regulatory-overview.md %}) - GDPR, FedRAMP, HIPAA, PCI DSS, ITAR
68+
- [Data Residency vs. Sovereignty]({{ site.baseurl }}{% link level-100/data-residency-concepts.md %}) - Definitions and Azure implementation
69+
- [Operational Sovereignty]({{ site.baseurl }}{% link level-100/operational-sovereignty.md %}) - Control plane concepts and Azure Local modes
7070

7171
**Assessment:**
72-
- [Knowledge Check Quiz](knowledge-check) - 15 questions to test your understanding
72+
- [Knowledge Check Quiz]({{ site.baseurl }}{% link level-100/knowledge-check.md %}) - 15 questions to test your understanding
7373

7474
**Key Concepts:**
7575
- Data residency and localization
@@ -83,15 +83,15 @@ Before starting Level 100, ensure you have:
8383
**Duration:** 2-3 hours
8484

8585
📚 **Main Content:**
86-
- [Microsoft Sovereign Cloud Models Overview](sovereign-cloud-models) - Three models, comparison, and decision framework
86+
- [Microsoft Sovereign Cloud Models Overview]({{ site.baseurl }}{% link level-100/sovereign-cloud-models.md %}) - Three models, comparison, and decision framework
8787

8888
**Deep Dive Topics:**
89-
- [Sovereign Public Cloud](sovereign-public-cloud) - Azure with enhanced sovereignty controls and Microsoft Cloud for Sovereignty
90-
- [Sovereign Private Cloud](sovereign-private-cloud) - Azure Local (Connected and Disconnected modes) for dedicated infrastructure
91-
- [National Partner Clouds](national-partner-clouds) - Azure Government, Azure China, and partner-operated sovereign clouds
89+
- [Sovereign Public Cloud]({{ site.baseurl }}{% link level-100/sovereign-public-cloud.md %}) - Azure with enhanced sovereignty controls and Microsoft Cloud for Sovereignty
90+
- [Sovereign Private Cloud]({{ site.baseurl }}{% link level-100/sovereign-private-cloud.md %}) - Azure Local (Connected and Disconnected modes) for dedicated infrastructure
91+
- [National Partner Clouds]({{ site.baseurl }}{% link level-100/national-partner-clouds.md %}) - Azure Government, Azure China, and partner-operated sovereign clouds
9292

9393
**Assessment:**
94-
- [Cloud Models Knowledge Check](cloud-models-quiz) - 15 questions testing model selection and technical understanding
94+
- [Cloud Models Knowledge Check]({{ site.baseurl }}{% link level-100/cloud-models-quiz.md %}) - 15 questions testing model selection and technical understanding
9595

9696
**Key Concepts:**
9797
- Model differentiation (Public, Private, Partner)
@@ -106,16 +106,16 @@ Before starting Level 100, ensure you have:
106106
**Duration:** 2-3 hours
107107

108108
📚 **Main Content:**
109-
- [Azure Local Overview](azure-local-overview) - Architecture, deployment modes, customer scenarios
109+
- [Azure Local Overview]({{ site.baseurl }}{% link level-100/azure-local-overview.md %}) - Architecture, deployment modes, customer scenarios
110110

111111
**Deep Dive Topics:**
112-
- [Azure Local Architecture Deep Dive](azure-local-architecture) - Hardware, networking, security layers
113-
- [Connected Mode Operations](azure-local-connected-mode) - Azure integration, monitoring, update management
114-
- [Disconnected Mode Operations](azure-local-disconnected-mode) - Air-gapped deployment, periodic sync
115-
- [Hardware Requirements & Planning](azure-local-hardware) - Validated hardware, sizing, deployment checklist
112+
- [Azure Local Architecture Deep Dive]({{ site.baseurl }}{% link level-100/azure-local-architecture.md %}) - Hardware, networking, security layers
113+
- [Connected Mode Operations]({{ site.baseurl }}{% link level-100/azure-local-connected-mode.md %}) - Azure integration, monitoring, update management
114+
- [Disconnected Mode Operations]({{ site.baseurl }}{% link level-100/azure-local-disconnected-mode.md %}) - Air-gapped deployment, periodic sync
115+
- [Hardware Requirements & Planning]({{ site.baseurl }}{% link level-100/azure-local-hardware.md %}) - Validated hardware, sizing, deployment checklist
116116

117117
**Assessment:**
118-
- [Azure Local Knowledge Check](azure-local-quiz) - 15 questions testing deployment modes and technical concepts
118+
- [Azure Local Knowledge Check]({{ site.baseurl }}{% link level-100/azure-local-quiz.md %}) - 15 questions testing deployment modes and technical concepts
119119

120120
**Key Concepts:**
121121
- Connected vs. Disconnected deployment modes
@@ -132,15 +132,15 @@ Before starting Level 100, ensure you have:
132132
**Duration:** 1.5-2 hours
133133

134134
📚 **Main Content:**
135-
- [Azure Arc Introduction](azure-arc-intro) - Hybrid management, multi-cloud governance, three Arc services
135+
- [Azure Arc Introduction]({{ site.baseurl }}{% link level-100/azure-arc-intro.md %}) - Hybrid management, multi-cloud governance, three Arc services
136136

137137
**Deep Dive Topics:**
138-
- [Arc-enabled Servers](azure-arc-servers) - Windows/Linux management, policy, monitoring
139-
- [Arc-enabled Kubernetes](azure-arc-kubernetes) - GitOps, multi-cluster management, policy enforcement
140-
- [Arc-enabled Data Services](azure-arc-data-services) - SQL MI and PostgreSQL on any infrastructure
138+
- [Arc-enabled Servers]({{ site.baseurl }}{% link level-100/azure-arc-servers.md %}) - Windows/Linux management, policy, monitoring
139+
- [Arc-enabled Kubernetes]({{ site.baseurl }}{% link level-100/azure-arc-kubernetes.md %}) - GitOps, multi-cluster management, policy enforcement
140+
- [Arc-enabled Data Services]({{ site.baseurl }}{% link level-100/azure-arc-data-services.md %}) - SQL MI and PostgreSQL on any infrastructure
141141

142142
**Assessment:**
143-
- [Azure Arc Knowledge Check](azure-arc-quiz) - 12 questions covering all Arc services
143+
- [Azure Arc Knowledge Check]({{ site.baseurl }}{% link level-100/azure-arc-quiz.md %}) - 12 questions covering all Arc services
144144

145145
**Key Concepts:**
146146
- Unified control plane for hybrid/multi-cloud
@@ -157,15 +157,15 @@ Before starting Level 100, ensure you have:
157157
**Duration:** 2-2.5 hours
158158

159159
📚 **Main Content:**
160-
- [Edge RAG Concepts](edge-rag-concepts) - RAG fundamentals, edge deployment benefits, customer scenarios
160+
- [Edge RAG Concepts]({{ site.baseurl }}{% link level-100/edge-rag-concepts.md %}) - RAG fundamentals, edge deployment benefits, customer scenarios
161161

162162
**Deep Dive Topics:**
163-
- [RAG Fundamentals](rag-fundamentals) - Embeddings, vector databases, LLM limitations
164-
- [Edge RAG Architecture](edge-rag-architecture) - Local LLM deployment, ingestion pipeline, query processing
165-
- [Edge RAG Use Cases and Implementation](edge-rag-use-cases) - Industry scenarios, best practices, ROI
163+
- [RAG Fundamentals]({{ site.baseurl }}{% link level-100/rag-fundamentals.md %}) - Embeddings, vector databases, LLM limitations
164+
- [Edge RAG Architecture]({{ site.baseurl }}{% link level-100/edge-rag-architecture.md %}) - Local LLM deployment, ingestion pipeline, query processing
165+
- [Edge RAG Use Cases and Implementation]({{ site.baseurl }}{% link level-100/edge-rag-use-cases.md %}) - Industry scenarios, best practices, ROI
166166

167167
**Assessment:**
168-
- [Edge RAG Knowledge Check](edge-rag-quiz) - 15 questions testing RAG concepts and implementation
168+
- [Edge RAG Knowledge Check]({{ site.baseurl }}{% link level-100/edge-rag-quiz.md %}) - 15 questions testing RAG concepts and implementation
169169

170170
**Key Concepts:**
171171
- RAG (Retrieval-Augmented Generation) basics
@@ -243,7 +243,7 @@ Test your understanding with these questions:
243243
4. What is Retrieval-Augmented Generation (RAG)?
244244
5. Why is data residency important for sovereign workloads?
245245

246-
**[Take the Level 100 Quiz →](knowledge-check)**
246+
**[Take the Level 100 Quiz →]({{ site.baseurl }}{% link level-100/knowledge-check.md %})**
247247

248248
---
249249

docs/level-200/README.md

Lines changed: 32 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -63,11 +63,11 @@ Before starting Level 200, ensure you have:
6363
Explore advanced Azure Local deployment patterns, hardware planning, high-availability architectures, and advanced networking scenarios for enterprise edge deployments.
6464

6565
**Core Topics:**
66-
- [Main Page: Azure Local Architecture Deep Dive](azure-local-architecture-deep-dive)
67-
- [Hardware Planning & Sizing](azure-local-hardware-planning)
68-
- [High-Availability Patterns](azure-local-ha-patterns)
69-
- [Advanced Networking Configurations](azure-local-advanced-networking)
70-
- [Assessment: Deep Dive Quiz](azure-local-deep-dive-quiz)
66+
- [Main Page: Azure Local Architecture Deep Dive]({{ site.baseurl }}{% link level-200/azure-local-architecture-deep-dive.md %})
67+
- [Hardware Planning & Sizing]({{ site.baseurl }}{% link level-200/azure-local-hardware-planning.md %})
68+
- [High-Availability Patterns]({{ site.baseurl }}{% link level-200/azure-local-ha-patterns.md %})
69+
- [Advanced Networking Configurations]({{ site.baseurl }}{% link level-200/azure-local-advanced-networking.md %})
70+
- [Assessment: Deep Dive Quiz]({{ site.baseurl }}{% link level-200/azure-local-deep-dive-quiz.md %})
7171

7272
---
7373

@@ -78,11 +78,11 @@ Explore advanced Azure Local deployment patterns, hardware planning, high-availa
7878
Master enterprise-scale governance, cost optimization, and security hardening for Azure Arc across hybrid and multi-cloud environments.
7979

8080
**Core Topics:**
81-
- [Main Page: Arc Advanced Management](arc-advanced-management)
82-
- [Policy & Governance at Scale](arc-policy-and-governance)
83-
- [Cost Optimization Strategies](arc-cost-optimization)
84-
- [Enterprise Deployment Patterns](arc-enterprise-patterns)
85-
- [Assessment: Advanced Quiz](arc-advanced-quiz)
81+
- [Main Page: Arc Advanced Management]({{ site.baseurl }}{% link level-200/arc-advanced-management.md %})
82+
- [Policy & Governance at Scale]({{ site.baseurl }}{% link level-200/arc-policy-and-governance.md %})
83+
- [Cost Optimization Strategies]({{ site.baseurl }}{% link level-200/arc-cost-optimization.md %})
84+
- [Enterprise Deployment Patterns]({{ site.baseurl }}{% link level-200/arc-enterprise-patterns.md %})
85+
- [Assessment: Advanced Quiz]({{ site.baseurl }}{% link level-200/arc-advanced-quiz.md %})
8686

8787
---
8888

@@ -93,12 +93,12 @@ Master enterprise-scale governance, cost optimization, and security hardening fo
9393
Master production-ready Retrieval-Augmented Generation deployment patterns, LLM optimization, vector database tuning, and operational excellence for enterprise edge deployments.
9494

9595
**Core Topics:**
96-
- [Main Page: Edge RAG Implementation](edge-rag-implementation)
97-
- [LLM Inference Optimization](llm-inference-optimization)
98-
- [Vector Databases for Edge](vector-databases-edge)
99-
- [RAG Deployment Strategies](rag-deployment-strategies)
100-
- [RAG Operations & Monitoring](rag-operations-monitoring)
101-
- [Assessment: Implementation Quiz](rag-implementation-quiz)
96+
- [Main Page: Edge RAG Implementation]({{ site.baseurl }}{% link level-200/edge-rag-implementation.md %})
97+
- [LLM Inference Optimization]({{ site.baseurl }}{% link level-200/llm-inference-optimization.md %})
98+
- [Vector Databases for Edge]({{ site.baseurl }}{% link level-200/vector-databases-edge.md %})
99+
- [RAG Deployment Strategies]({{ site.baseurl }}{% link level-200/rag-deployment-strategies.md %})
100+
- [RAG Operations & Monitoring]({{ site.baseurl }}{% link level-200/rag-operations-monitoring.md %})
101+
- [Assessment: Implementation Quiz]({{ site.baseurl }}{% link level-200/rag-implementation-quiz.md %})
102102

103103
---
104104

@@ -109,11 +109,11 @@ Master production-ready Retrieval-Augmented Generation deployment patterns, LLM
109109
Master customer discovery, solution architecture, sizing methodologies, and business case development for sovereign cloud implementations.
110110

111111
**Core Topics:**
112-
- [Main Page: Pre-Sales Solution Design](presales-solution-design)
113-
- [Customer Discovery Framework](customer-discovery)
114-
- [Solution Sizing Methodologies](solution-sizing)
115-
- [TCO & Cost Estimation](cost-estimation)
116-
- [Assessment: Sales Scenarios Quiz](presales-quiz)
112+
- [Main Page: Pre-Sales Solution Design]({{ site.baseurl }}{% link level-200/presales-solution-design.md %})
113+
- [Customer Discovery Framework]({{ site.baseurl }}{% link level-200/customer-discovery.md %})
114+
- [Solution Sizing Methodologies]({{ site.baseurl }}{% link level-200/solution-sizing.md %})
115+
- [TCO & Cost Estimation]({{ site.baseurl }}{% link level-200/cost-estimation.md %})
116+
- [Assessment: Sales Scenarios Quiz]({{ site.baseurl }}{% link level-200/presales-quiz.md %})
117117

118118
---
119119

@@ -124,12 +124,12 @@ Master customer discovery, solution architecture, sizing methodologies, and busi
124124
Master regulatory compliance frameworks (GDPR, FedRAMP), encryption strategies, key management, security hardening, and incident response for sovereign cloud deployments.
125125

126126
**Core Topics:**
127-
- [Main Page: Compliance & Security Patterns](compliance-security-patterns)
128-
- [GDPR Implementation Guide](gdpr-implementation)
129-
- [FedRAMP Compliance](fedramp-compliance)
130-
- [Encryption & Key Management](encryption-key-management)
131-
- [Security Hardening Practices](security-hardening)
132-
- [Assessment: Compliance Quiz](compliance-quiz)
127+
- [Main Page: Compliance & Security Patterns]({{ site.baseurl }}{% link level-200/compliance-security-patterns.md %})
128+
- [GDPR Implementation Guide]({{ site.baseurl }}{% link level-200/gdpr-implementation.md %})
129+
- [FedRAMP Compliance]({{ site.baseurl }}{% link level-200/fedramp-compliance.md %})
130+
- [Encryption & Key Management]({{ site.baseurl }}{% link level-200/encryption-key-management.md %})
131+
- [Security Hardening Practices]({{ site.baseurl }}{% link level-200/security-hardening.md %})
132+
- [Assessment: Compliance Quiz]({{ site.baseurl }}{% link level-200/compliance-quiz.md %})
133133

134134
---
135135

@@ -140,15 +140,15 @@ Master regulatory compliance frameworks (GDPR, FedRAMP), encryption strategies,
140140
Five progressive hands-on labs reinforcing Modules 1-5 through practical implementation of Azure Local, Azure Arc, Edge RAG, policy governance, and monitoring in a complete sovereign cloud environment.
141141

142142
**Lab Overview:**
143-
1. [Lab 1: Azure Local Deployment](lab-01-azure-local-deployment) (2-3h)
143+
1. [Lab 1: Azure Local Deployment]({{ site.baseurl }}{% link level-200/lab-01-azure-local-deployment.md %}) (2-3h)
144144
- Deploy Azure Local in connected mode with sample applications
145-
2. [Lab 2: Azure Arc Onboarding](lab-02-azure-arc-onboarding) (2-3h)
145+
2. [Lab 2: Azure Arc Onboarding]({{ site.baseurl }}{% link level-200/lab-02-azure-arc-onboarding.md %}) (2-3h)
146146
- Register and manage resources with Arc, GitOps, extensions
147-
3. [Lab 3: Edge RAG Setup](lab-03-edge-rag-setup) (3-4h)
147+
3. [Lab 3: Edge RAG Setup]({{ site.baseurl }}{% link level-200/lab-03-edge-rag-setup.md %}) (3-4h)
148148
- Complete RAG system with Weaviate, Ollama, and FastAPI
149-
4. [Lab 4: Policy & Governance](lab-04-policy-governance) (2-3h)
149+
4. [Lab 4: Policy & Governance]({{ site.baseurl }}{% link level-200/lab-04-policy-governance.md %}) (2-3h)
150150
- Custom policies, Kubernetes enforcement, compliance monitoring
151-
5. [Lab 5: Monitoring & Observability](lab-05-monitoring-observability) (2-3h)
151+
5. [Lab 5: Monitoring & Observability]({{ site.baseurl }}{% link level-200/lab-05-monitoring-observability.md %}) (2-3h)
152152
- End-to-end monitoring with Log Analytics, alerts, and dashboards
153153

154154
**[Module 6 Overview & Navigation](../level-200/README)**

docs/level-300/README.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -60,39 +60,39 @@ Before starting Level 300, ensure you have:
6060

6161
**Duration:** 6-8 hours
6262

63-
- [Zero Trust Principles](zero-trust)
63+
- [Zero Trust Principles]({{ site.baseurl }}{% link level-300/zero-trust.md %})
6464
- [Implementation Patterns](zero-trust#implementation)
6565
- [Monitoring and Compliance](zero-trust#monitoring)
6666

6767
### 2. Azure Local at Scale - Connected
6868

6969
**Duration:** 8-10 hours
7070

71-
- [Advanced Networking](azure-local-advanced-connected)
71+
- [Advanced Networking]({{ site.baseurl }}{% link level-300/azure-local-advanced-connected.md %})
7272
- [Multi-Site Deployments](azure-local-advanced-connected#multi-site)
7373
- [Cloud-Integrated Updates](azure-local-advanced-connected#updates)
7474

7575
### 3. Azure Local at Scale - Disconnected
7676

7777
**Duration:** 8-10 hours
7878

79-
- [Air-Gapped Operations](azure-local-advanced-disconnected)
79+
- [Air-Gapped Operations]({{ site.baseurl }}{% link level-300/azure-local-advanced-disconnected.md %})
8080
- [Manual Update Procedures](azure-local-advanced-disconnected#updates)
8181
- [Certificate Lifecycle Management](azure-local-advanced-disconnected#certificates)
8282

8383
### 4. Production Edge RAG Deployment
8484

8585
**Duration:** 10-12 hours
8686

87-
- [Production Architecture](edge-rag-production)
87+
- [Production Architecture]({{ site.baseurl }}{% link level-300/edge-rag-production.md %})
8888
- [Performance Optimization](edge-rag-production#optimization)
8989
- [MLOps at the Edge](edge-rag-production#mlops)
9090

9191
### 5. Advanced Troubleshooting
9292

9393
**Duration:** 6-8 hours
9494

95-
- [Diagnostic Tools and Techniques](troubleshooting)
95+
- [Diagnostic Tools and Techniques]({{ site.baseurl }}{% link level-300/troubleshooting.md %})
9696
- [Common Issues and Resolutions](troubleshooting#common-issues)
9797
- [Support Escalation Paths](troubleshooting#escalation)
9898

0 commit comments

Comments
 (0)