Skip to content

Commit 77b2f62

Browse files
jonathan-vellajonathan-vella
committed
Initial commit: Microsoft Sovereign Cloud Brain Trek
Complete technical documentation and training platform for: - Digital Sovereignty & Azure Local - Azure Arc & Hybrid Management - Edge RAG (AI at the Edge) - Compliance & Security Patterns 133+ documentation pages, 87 visual assets. Validated against November 2025 Microsoft Learn documentation.
0 parents  commit 77b2f62

292 files changed

Lines changed: 183734 additions & 0 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.

‎.devcontainer/devcontainer.json‎

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
{
2+
"name": "Sovereign Cloud Brain Trek",
3+
"image": "mcr.microsoft.com/devcontainers/jekyll:2-bookworm",
4+
5+
// Features to add - Node.js for markdownlint-cli2, Python for diagram generation
6+
"features": {
7+
"ghcr.io/devcontainers/features/node:1": {
8+
"version": "lts"
9+
},
10+
"ghcr.io/devcontainers/features/python:1": {
11+
"version": "3.12"
12+
}
13+
},
14+
15+
// Configure tool-specific properties.
16+
"customizations": {
17+
"vscode": {
18+
"extensions": [
19+
"shopify.ruby-lsp",
20+
"sissel.shopify-liquid",
21+
"DavidAnson.vscode-markdownlint",
22+
"yzhang.markdown-all-in-one",
23+
"bierner.markdown-mermaid",
24+
"redhat.vscode-yaml",
25+
"EditorConfig.EditorConfig",
26+
"esbenp.prettier-vscode"
27+
],
28+
"settings": {
29+
"markdownlint.config": {
30+
"extends": "${workspaceFolder}/.markdownlint.json"
31+
},
32+
"markdownlint.run": "onSave"
33+
}
34+
}
35+
},
36+
37+
// Use 'forwardPorts' to make a list of ports inside the container available locally.
38+
"forwardPorts": [4000],
39+
40+
// Use 'postCreateCommand' to run commands after the container is created.
41+
// Install graphviz for diagrams, cartopy dependencies for geographic maps
42+
"postCreateCommand": "sh /usr/local/post-create.sh && sudo apt-get update && sudo apt-get install -y graphviz libgeos-dev libproj-dev proj-data proj-bin && pip install -r requirements.txt && npm install -g markdownlint-cli2 && pre-commit install"
43+
}

‎.editorconfig‎

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
# EditorConfig helps maintain consistent coding styles
2+
# https://editorconfig.org
3+
4+
root = true
5+
6+
# Default settings for all files
7+
[*]
8+
charset = utf-8
9+
end_of_line = lf
10+
insert_final_newline = true
11+
trim_trailing_whitespace = true
12+
indent_style = space
13+
indent_size = 2
14+
15+
# Markdown files
16+
[*.md]
17+
# Preserve trailing whitespace for line breaks
18+
trim_trailing_whitespace = false
19+
max_line_length = off
20+
21+
# YAML files
22+
[*.{yml,yaml}]
23+
indent_size = 2
24+
25+
# JSON files
26+
[*.json]
27+
indent_size = 2
28+
29+
# Ruby files (Gemfile)
30+
[{Gemfile,*.rb}]
31+
indent_size = 2
32+
33+
# Shell scripts
34+
[*.sh]
35+
indent_size = 2
36+
37+
# Batch files (Windows)
38+
[*.{bat,cmd}]
39+
end_of_line = crlf

‎.github/ISSUE_TEMPLATE/bug_report.yml‎

Lines changed: 106 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,106 @@
1+
name: Bug Report
2+
description: Report broken links, display issues, or technical problems with the site
3+
labels: ["bug", "triage"]
4+
title: "[Bug] "
5+
assignees: []
6+
body:
7+
- type: markdown
8+
attributes:
9+
value: |
10+
Thanks for reporting a bug! Please fill out the information below to help us fix the issue quickly.
11+
12+
- type: dropdown
13+
id: bug_type
14+
attributes:
15+
label: Bug Type
16+
options:
17+
- Broken link (internal)
18+
- Broken link (external)
19+
- Display/rendering issue
20+
- Navigation problem
21+
- Search not working
22+
- Mobile responsiveness
23+
- Build failure
24+
- Other
25+
description: What type of bug are you reporting?
26+
validations:
27+
required: true
28+
29+
- type: input
30+
id: page_url
31+
attributes:
32+
label: Page URL
33+
description: The URL of the page where you encountered the bug
34+
placeholder: https://jonathan-vella.github.io/sov-cloud-brain-trek/...
35+
validations:
36+
required: true
37+
38+
- type: textarea
39+
id: description
40+
attributes:
41+
label: Bug Description
42+
description: A clear description of what the bug is
43+
placeholder: Describe what went wrong...
44+
validations:
45+
required: true
46+
47+
- type: textarea
48+
id: expected
49+
attributes:
50+
label: Expected Behavior
51+
description: What did you expect to happen?
52+
placeholder: I expected...
53+
validations:
54+
required: true
55+
56+
- type: textarea
57+
id: steps
58+
attributes:
59+
label: Steps to Reproduce
60+
description: How can we reproduce this bug?
61+
placeholder: |
62+
1. Go to '...'
63+
2. Click on '...'
64+
3. Scroll down to '...'
65+
4. See error
66+
validations:
67+
required: true
68+
69+
- type: dropdown
70+
id: browser
71+
attributes:
72+
label: Browser
73+
options:
74+
- Chrome
75+
- Firefox
76+
- Safari
77+
- Edge
78+
- Other
79+
description: Which browser are you using?
80+
validations:
81+
required: true
82+
83+
- type: dropdown
84+
id: device
85+
attributes:
86+
label: Device
87+
options:
88+
- Desktop
89+
- Tablet
90+
- Mobile
91+
description: What device are you using?
92+
validations:
93+
required: true
94+
95+
- type: textarea
96+
id: screenshots
97+
attributes:
98+
label: Screenshots
99+
description: If applicable, add screenshots to help explain the problem
100+
placeholder: Drag and drop images here...
101+
102+
- type: textarea
103+
id: additional
104+
attributes:
105+
label: Additional Context
106+
description: Any other information that might help us fix this bug

‎.github/ISSUE_TEMPLATE/config.yml‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
blank_issues_enabled: false
2+
contact_links:
3+
- name: 💬 GitHub Discussions
4+
url: https://github.com/jonathan-vella/sov-cloud-brain-trek/discussions
5+
about: Ask questions, share ideas, or discuss the learning program
6+
- name: 📖 Microsoft Learn
7+
url: https://learn.microsoft.com/en-us/industry/sovereign-cloud/
8+
about: Official Microsoft Sovereign Cloud documentation
9+
- name: 🔒 Security Issue
10+
url: https://github.com/jonathan-vella/sov-cloud-brain-trek/security/advisories/new
11+
about: Report security vulnerabilities privately

‎.github/ISSUE_TEMPLATE/feature_request.yml‎

Lines changed: 97 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,97 @@
1+
name: Feature Request
2+
description: Suggest a new feature, module, or improvement to the learning program
3+
labels: ["enhancement", "triage"]
4+
title: "[Feature] "
5+
assignees: []
6+
body:
7+
- type: markdown
8+
attributes:
9+
value: |
10+
Thanks for suggesting an improvement! Your ideas help make this learning program better.
11+
12+
- type: dropdown
13+
id: feature_type
14+
attributes:
15+
label: Feature Type
16+
options:
17+
- New learning module
18+
- New hands-on lab
19+
- New knowledge check questions
20+
- Visual asset/diagram
21+
- Navigation improvement
22+
- Search enhancement
23+
- Accessibility improvement
24+
- Documentation improvement
25+
- Tool/workflow improvement
26+
- Other
27+
description: What type of feature are you requesting?
28+
validations:
29+
required: true
30+
31+
- type: dropdown
32+
id: learning_level
33+
attributes:
34+
label: Target Learning Level
35+
options:
36+
- Level 50 - Essentials
37+
- Level 100 - Foundational
38+
- Level 200 - Intermediate
39+
- Level 300 - Advanced
40+
- All Levels
41+
- N/A
42+
description: Which learning level would this feature support?
43+
validations:
44+
required: true
45+
46+
- type: dropdown
47+
id: audience
48+
attributes:
49+
label: Target Audience
50+
options:
51+
- Sales & Pre-Sales
52+
- Technical Professionals
53+
- Both audiences
54+
- All users
55+
description: Who would benefit most from this feature?
56+
validations:
57+
required: true
58+
59+
- type: textarea
60+
id: problem
61+
attributes:
62+
label: Problem Statement
63+
description: What problem does this feature solve? What gap does it fill?
64+
placeholder: Describe the problem or need...
65+
validations:
66+
required: true
67+
68+
- type: textarea
69+
id: solution
70+
attributes:
71+
label: Proposed Solution
72+
description: Describe your proposed feature or improvement
73+
placeholder: I would like...
74+
validations:
75+
required: true
76+
77+
- type: textarea
78+
id: alternatives
79+
attributes:
80+
label: Alternatives Considered
81+
description: Have you considered any alternative solutions or features?
82+
placeholder: I also considered...
83+
84+
- type: textarea
85+
id: references
86+
attributes:
87+
label: References
88+
description: Any Microsoft Learn links, examples, or documentation that could inform this feature?
89+
placeholder: |
90+
- https://learn.microsoft.com/...
91+
- https://...
92+
93+
- type: textarea
94+
id: additional
95+
attributes:
96+
label: Additional Context
97+
description: Add any other context, mockups, or examples about the feature request

‎.github/ISSUE_TEMPLATE/sov-cloud-brain-trek-issues.yml‎

Lines changed: 80 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
name: Sovereign Cloud Brain Trek Issue
2+
description: Report content issues, suggest improvements, or contribute to the Sovereign Cloud learning program
3+
labels: ["triage"]
4+
title: "[Issue] "
5+
assignees: []
6+
body:
7+
- type: dropdown
8+
id: issue_type
9+
attributes:
10+
label: Issue Type
11+
options:
12+
- Content Error/Correction
13+
- Documentation Improvement
14+
- Lab/Exercise Issue
15+
- Quiz Question Issue
16+
- New Content Suggestion
17+
- Visual Asset Specification
18+
- Technical Question
19+
- Other
20+
description: What type of issue are you reporting?
21+
validations:
22+
required: true
23+
24+
- type: dropdown
25+
id: learning_level
26+
attributes:
27+
label: Learning Level
28+
options:
29+
- Level 50 - Essentials
30+
- Level 100 - Foundational
31+
- Level 200 - Intermediate
32+
- Level 300 - Advanced
33+
- All Levels
34+
description: Which learning level does this affect?
35+
validations:
36+
required: true
37+
38+
- type: checkboxes
39+
id: modules
40+
attributes:
41+
label: Module(s) Involved
42+
options:
43+
- label: Digital Sovereignty & Sovereignty Models
44+
- label: Cloud Models Overview
45+
- label: Azure Local
46+
- label: Azure Arc
47+
- label: Edge RAG (Retrieval-Augmented Generation)
48+
- label: Security & Compliance
49+
- label: Cost Optimization
50+
- label: Multiple/Other
51+
52+
- type: textarea
53+
id: description
54+
attributes:
55+
label: Description
56+
description: Clearly describe the issue, suggestion, or question. Include specific details, page numbers/section names, and steps to reproduce if applicable.
57+
validations:
58+
required: true
59+
60+
- type: textarea
61+
id: content_context
62+
attributes:
63+
label: Relevant Content Context
64+
description: |
65+
- Which file/module is affected? (e.g., docs/level-100/azure-local-overview.md)
66+
- What's the specific section or quiz question number?
67+
- Any error messages, broken links, or incorrect information?
68+
- Relevant screenshots or examples?
69+
70+
- type: textarea
71+
id: solution
72+
attributes:
73+
label: Suggested Solution (if applicable)
74+
description: If you have a proposed fix, correction, or new content idea, describe it here.
75+
76+
- type: textarea
77+
id: additional_context
78+
attributes:
79+
label: Additional Context
80+
description: Add any other context, references, external resources, or Microsoft Learn links that may help.

0 commit comments

Comments
 (0)