Skip to content

Commit 1df5264

Browse files
kristopherjturnerkristopherjturner
committed
feat: migrate Azure Local Anywhere docs into Docusaurus site
- Migrate ~250 MDX/MD files from product-azure-local-anywhere into docs/ - Scaffold 59 target directories with _category_.json sidebar config - Full branding scrub: all 15 patterns (TierPoint, prodtech, improbability, etc.) at zero - Fix 177 broken internal links across 10+ rounds of bulk corrections - Copy 6 .drawio diagram files to docs/assets/diagrams/ - Convert GitLab CI badges to GitHub equivalents - Add numberPrefixParser: false to preserve URL number prefixes - Replace DocCardList with static link list in docs/index.mdx - Create design section index page - Add Toolkit to Solutions navbar dropdown and footer - Remove old docs-lab-env and docs-planning-for-azure-local stubs Closes #11
1 parent 8ae4725 commit 1df5264

324 files changed

Lines changed: 68251 additions & 60 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.

‎azurelocal-github-io.code-workspace‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,9 @@
1919
{
2020
"name": "azurelocal-vm-conversion-toolkit",
2121
"path": "../azurelocal-vm-conversion-toolkit"
22+
},
23+
{
24+
"path": "../azurelocal-toolkit"
2225
}
2326
],
2427
"settings": {

‎docs/assets/_category_.json‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
{
2+
"collapsible": true,
3+
"collapsed": true,
4+
"position": 8,
5+
"label": "Assets"
6+
}

‎docs/assets/diagrams/_category_.json‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
{"label":"Diagrams","position":1}

‎docs/assets/diagrams/hld/_category_.json‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
{"label":"HLD Diagrams","position":1}

‎docs/assets/diagrams/hld/azure-local-anywhere-management.drawio‎

Lines changed: 256 additions & 0 deletions
Large diffs are not rendered by default.

‎docs/assets/diagrams/hld/azure-local-anywhere-onprem.drawio‎

Lines changed: 192 additions & 0 deletions
Large diffs are not rendered by default.

‎docs/assets/diagrams/hld/azure-local-anywhere-topology.drawio‎

Lines changed: 191 additions & 0 deletions
Large diffs are not rendered by default.

‎docs/assets/diagrams/index.mdx‎

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
---
2+
title: "Diagrams"
3+
sidebar_label: "Diagrams"
4+
sidebar_position: 2
5+
description: "Source diagram files for Azure Local Anywhere"
6+
---
7+
8+
# Diagrams
9+
10+
[![Reference](https://img.shields.io/badge/Type-Reference-purple?style=flat-square)](../index.mdx)
11+
[![Azure](https://img.shields.io/badge/Platform-Azure_Local-0078D4?style=flat-square&logo=microsoftazure)](https://learn.microsoft.com/en-us/azure/azure-local/)
12+
13+
> **DOCUMENT CATEGORY**: Reference
14+
> **SCOPE**: Source diagram files
15+
> **PURPOSE**: Store editable diagram source files
16+
> **MASTER REFERENCE**: [Microsoft Learn - Azure Local](https://learn.microsoft.com/en-us/azure/azure-local/)
17+
18+
**Status**: Active
19+
20+
---
21+
22+
Source diagram files for Azure Local Anywhere.
23+
24+
## File Types
25+
26+
- Draw.io files (`.drawio`)
27+
- Visio files (`.vsdx`)
28+
- PlantUML files (`.puml`)
29+
- Mermaid files (`.mmd`)
30+
- Other diagram source files
31+
32+
## Usage
33+
34+
- Keep source files here
35+
- Export images to ../images/ folder
36+
- Reference exported images in documentation

‎docs/assets/diagrams/lld/_category_.json‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
{"label":"LLD Diagrams","position":2}

‎docs/assets/diagrams/lld/lld-document-hierarchy.drawio‎

Lines changed: 84 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
1+
<mxfile host="app.diagrams.net" modified="2026-02-04T12:00:00.000Z" agent="Mozilla/5.0" etag="lld-doc-hierarchy" version="21.0.0" type="device">
2+
<diagram name="Document Hierarchy" id="lld-doc-hierarchy">
3+
<mxGraphModel dx="1200" dy="800" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="850" pageHeight="1100" math="0" shadow="0">
4+
<root>
5+
<mxCell id="0"/>
6+
<mxCell id="1" parent="0"/>
7+
8+
<!-- Title -->
9+
<mxCell id="title" value="Azure Local Anywhere - Documentation Hierarchy" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;fontSize=18;fontStyle=1;fontColor=#333333;" parent="1" vertex="1">
10+
<mxGeometry x="175" y="30" width="500" height="40" as="geometry"/>
11+
</mxCell>
12+
13+
<!-- HLD Box -->
14+
<mxCell id="hld-box" value="" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;strokeWidth=2;" parent="1" vertex="1">
15+
<mxGeometry x="250" y="100" width="350" height="120" as="geometry"/>
16+
</mxCell>
17+
<mxCell id="hld-title" value="HIGH-LEVEL DESIGN (HLD)" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;fontSize=14;fontStyle=1;fontColor=#1a365d;" parent="1" vertex="1">
18+
<mxGeometry x="275" y="110" width="300" height="30" as="geometry"/>
19+
</mxCell>
20+
<mxCell id="hld-content" value="• Solution architecture overview&#xa;• Component relationships&#xa;• Azure integration patterns&#xa;• Business alignment" style="text;html=1;strokeColor=none;fillColor=none;align=left;verticalAlign=top;whiteSpace=wrap;rounded=0;fontSize=11;fontColor=#333333;" parent="1" vertex="1">
21+
<mxGeometry x="280" y="145" width="300" height="70" as="geometry"/>
22+
</mxCell>
23+
24+
<!-- Arrow HLD to LLD -->
25+
<mxCell id="arrow1" value="" style="endArrow=classic;html=1;strokeWidth=3;strokeColor=#0078D4;exitX=0.5;exitY=1;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" parent="1" edge="1">
26+
<mxGeometry width="50" height="50" relative="1" as="geometry">
27+
<mxPoint x="425" y="220" as="sourcePoint"/>
28+
<mxPoint x="425" y="270" as="targetPoint"/>
29+
</mxGeometry>
30+
</mxCell>
31+
32+
<!-- LLD Box (highlighted) -->
33+
<mxCell id="lld-box" value="" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#fff2cc;strokeColor=#d6b656;strokeWidth=3;" parent="1" vertex="1">
34+
<mxGeometry x="250" y="270" width="350" height="140" as="geometry"/>
35+
</mxCell>
36+
<mxCell id="lld-indicator" value="YOU ARE HERE" style="text;html=1;strokeColor=none;fillColor=#ff6600;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=1;fontSize=10;fontStyle=1;fontColor=#ffffff;" parent="1" vertex="1">
37+
<mxGeometry x="475" y="275" width="100" height="20" as="geometry"/>
38+
</mxCell>
39+
<mxCell id="lld-title" value="LOW-LEVEL DESIGN (LLD)" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;fontSize=14;fontStyle=1;fontColor=#7c5a00;" parent="1" vertex="1">
40+
<mxGeometry x="275" y="280" width="300" height="30" as="geometry"/>
41+
</mxCell>
42+
<mxCell id="lld-content" value="• Detailed technical specifications&#xa;• Design decisions and rationale (ADRs)&#xa;• Configuration standards&#xa;• Hardware and network architecture&#xa;• Security and governance" style="text;html=1;strokeColor=none;fillColor=none;align=left;verticalAlign=top;whiteSpace=wrap;rounded=0;fontSize=11;fontColor=#333333;" parent="1" vertex="1">
43+
<mxGeometry x="280" y="315" width="300" height="90" as="geometry"/>
44+
</mxCell>
45+
46+
<!-- Arrow LLD to Implementation -->
47+
<mxCell id="arrow2" value="" style="endArrow=classic;html=1;strokeWidth=3;strokeColor=#0078D4;exitX=0.5;exitY=1;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" parent="1" edge="1">
48+
<mxGeometry width="50" height="50" relative="1" as="geometry">
49+
<mxPoint x="425" y="410" as="sourcePoint"/>
50+
<mxPoint x="425" y="460" as="targetPoint"/>
51+
</mxGeometry>
52+
</mxCell>
53+
54+
<!-- Implementation Box -->
55+
<mxCell id="impl-box" value="" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;strokeWidth=2;" parent="1" vertex="1">
56+
<mxGeometry x="250" y="460" width="350" height="120" as="geometry"/>
57+
</mxCell>
58+
<mxCell id="impl-title" value="IMPLEMENTATION GUIDES" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;fontSize=14;fontStyle=1;fontColor=#2d5016;" parent="1" vertex="1">
59+
<mxGeometry x="275" y="470" width="300" height="30" as="geometry"/>
60+
</mxCell>
61+
<mxCell id="impl-content" value="• Step-by-step deployment procedures&#xa;• Configuration templates&#xa;• Validation checklists&#xa;• Operational runbooks" style="text;html=1;strokeColor=none;fillColor=none;align=left;verticalAlign=top;whiteSpace=wrap;rounded=0;fontSize=11;fontColor=#333333;" parent="1" vertex="1">
62+
<mxGeometry x="280" y="505" width="300" height="70" as="geometry"/>
63+
</mxCell>
64+
65+
<!-- Side annotations -->
66+
<mxCell id="annotation1" value="Strategic&#xa;(What &amp; Why)" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;fontSize=10;fontStyle=2;fontColor=#6c8ebf;" parent="1" vertex="1">
67+
<mxGeometry x="620" y="140" width="80" height="40" as="geometry"/>
68+
</mxCell>
69+
<mxCell id="annotation2" value="Technical&#xa;(Specifications)" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;fontSize=10;fontStyle=2;fontColor=#d6b656;" parent="1" vertex="1">
70+
<mxGeometry x="620" y="320" width="80" height="40" as="geometry"/>
71+
</mxCell>
72+
<mxCell id="annotation3" value="Operational&#xa;(How)" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;fontSize=10;fontStyle=2;fontColor=#82b366;" parent="1" vertex="1">
73+
<mxGeometry x="620" y="500" width="80" height="40" as="geometry"/>
74+
</mxCell>
75+
76+
<!-- Footer -->
77+
<mxCell id="footer" value="TierPoint Azure Local Anywhere Documentation" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;fontSize=10;fontStyle=2;fontColor=#666666;" parent="1" vertex="1">
78+
<mxGeometry x="275" y="610" width="300" height="20" as="geometry"/>
79+
</mxCell>
80+
81+
</root>
82+
</mxGraphModel>
83+
</diagram>
84+
</mxfile>

0 commit comments

Comments
 (0)