Skip to content

Commit f7a7276

Browse files
halkazwinihalkazwini
committed
Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into nat
2 parents 811ddc9 + 34607cf commit f7a7276

626 files changed

Lines changed: 29743 additions & 25547 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.

‎.github/copilot/skills/extended-zones-article-writer.md‎

Lines changed: 131 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,131 @@
1+
# Extended Zones Article Writer
2+
3+
Write production-ready how-to, quickstart, tutorial, or overview articles for the Azure Extended Zones Learn documentation.
4+
5+
## Context Sources
6+
7+
### Existing articles (reference for style and structure)
8+
- **Directory:** `C:\github\azure-docs-pr\articles\extended-zones\`
9+
- **Best style reference:** `create-storage-account.md` (canonical how-to example)
10+
- **TOC:** `TOC.yml` — defines the site navigation structure
11+
- **Overview:** `overview.md` — contains the supported services table
12+
13+
### Team code repos (for technical accuracy)
14+
- `C:\github\AzureStack-Fiji-Workloads` — team workloads and service code
15+
- `C:\github\Extended-Zones-Core-Platform` — core platform code
16+
- `C:\github\Fiji-Services-EdgeZoneRP` — Edge Zone resource provider
17+
- `C:\github\Fiji-EdgeZones-TSG-TeamDocs` — troubleshooting and team docs
18+
- `C:\github\EdgeZones-Operations-Configuration` — operations config
19+
- `C:\github\EdgeZones-Operations-Validation` — validation scripts
20+
21+
---
22+
23+
## Frontmatter Template
24+
25+
```yaml
26+
---
27+
title: <Descriptive title — verb + noun + "in an Azure Extended Zone">
28+
description: <One sentence, under 160 characters, starting with "Learn how to...">
29+
author: svaldesgzz
30+
ms.author: svaldes
31+
ms.service: azure-extended-zones
32+
ms.topic: <how-to | quickstart | tutorial | overview | concept-article>
33+
ms.date: <MM/DD/YYYY>
34+
---
35+
```
36+
37+
---
38+
39+
## Article Naming Conventions
40+
41+
| Type | Pattern | Example |
42+
|---|---|---|
43+
| How-to | `[action]-[resource].md` | `create-storage-account.md` |
44+
| Quickstart | `deploy-[resource]-[method].md` | `deploy-vm-portal.md` |
45+
| Tutorial | `[action]-[resource].md` | `backup-virtual-machine.md` |
46+
| Overview | `overview.md` or `[topic]-overview.md` | `overview.md` |
47+
48+
---
49+
50+
## Article Structure by Type
51+
52+
### How-to guide (`ms.topic: how-to`)
53+
1. H1 title
54+
2. Intro paragraph ("In this article, you learn how to...")
55+
3. `## Prerequisites` — subscription, Extended Zone access, tools
56+
4. `## Sign in to Azure` — standard portal sign-in step
57+
5. Main task sections (H2 per major step)
58+
6. `## Clean up resources` — portal resource group deletion
59+
7. `## Related content` — 3–4 bullet links to related articles
60+
61+
### Quickstart (`ms.topic: quickstart`)
62+
Same as how-to but faster-paced, single focused task, ends with a "Next steps" section.
63+
64+
### Tutorial (`ms.topic: tutorial`)
65+
Multi-step, progressive task. Each H2 section builds on the previous one.
66+
67+
---
68+
69+
## Key Formatting Rules
70+
71+
**Tables** (use for all settings/configuration steps):
72+
```markdown
73+
| Setting | Value |
74+
| --- | --- |
75+
| Key vault name | Enter a unique name, such as *myKeyVault*. |
76+
| Region | Select the **parent region** of the target Extended Zone. |
77+
```
78+
79+
**Note/Important/Caution blocks:**
80+
```markdown
81+
> [!NOTE]
82+
> Note text here.
83+
84+
> [!IMPORTANT]
85+
> Critical info here.
86+
87+
> [!CAUTION]
88+
> Warning text here.
89+
```
90+
91+
**Code blocks** — always use language-specific fences:
92+
- Azure CLI: ` ```azurecli `
93+
- PowerShell: ` ```azurepowershell `
94+
- JSON: ` ```json `
95+
- Bash: ` ```bash `
96+
97+
**Cross-links** — use relative paths:
98+
```markdown
99+
[Request access to an Azure Extended Zone](request-access.md)
100+
```
101+
102+
**No screenshots** — use text instructions and tables only (no `:::image` directives).
103+
104+
---
105+
106+
## Extended Zone–Specific Notes
107+
108+
- **Key Vault, Disk Encryption Sets, and most control-plane services** are created in the **parent Azure region**, not the Extended Zone itself.
109+
- **VMs, AKS clusters, storage accounts** are deployed **in the Extended Zone** using `--edge-zone <zone-name>` in the CLI or by selecting "Deploy to an Azure Extended Zone" in the portal under the Region field.
110+
- Always remind users: select the **parent region** first in the portal, then select **Deploy to an Azure Extended Zone** and choose the Extended Zone.
111+
- Storage in Extended Zones is **Premium only** with **LRS** redundancy.
112+
- Refer to `request-access.md` whenever Extended Zone access or zone names are needed.
113+
114+
---
115+
116+
## Publishing Checklist
117+
118+
After writing the article:
119+
120+
1. **Save the file** to `C:\github\azure-docs-pr\articles\extended-zones\<filename>.md`
121+
122+
2. **Update `TOC.yml`** — add an entry under the appropriate section:
123+
```yaml
124+
- name: <Short descriptive name>
125+
href: <filename>.md
126+
```
127+
Sections in TOC: Overview, Quickstarts, Tutorials, Concepts, How-to guides, Arc-enabled PaaS workloads, Security, Reference, Resources
128+
129+
3. **Update `overview.md`** if the article covers a new service — add it to the supported services table under the correct category row (`Compute`, `Networking`, `Storage`, `BCDR`, `Arc-enabled PaaS`, `Other`). Services use `<br>` as separator and are written as markdown links.
130+
131+
4. **Verify frontmatter** — all required fields present (`title`, `description`, `author`, `ms.author`, `ms.service`, `ms.topic`, `ms.date`).

‎.openpublishing.redirection.json‎

Lines changed: 238 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,237 @@
11
{
22
"redirections": [
3+
{
4+
"source_path": "articles/migrate/best-practices-assessment.md",
5+
"redirect_url": "/previous-versions/azure/migrate/best-practices-assessment",
6+
"redirect_document_id": false,
7+
"monikers": [
8+
"migrate"
9+
]
10+
},
11+
{
12+
"source_path": "articles/migrate/concepts-assessment-calculation.md",
13+
"redirect_url": "/previous-versions/azure/migrate/concepts-assessment-calculation",
14+
"redirect_document_id": false,
15+
"monikers": [
16+
"migrate"
17+
]
18+
},
19+
{
20+
"source_path": "articles/migrate/concepts-azure-sap-systems-assessment.md",
21+
"redirect_url": "/previous-versions/azure/migrate/concepts-azure-sap-systems-assessment",
22+
"redirect_document_id": false,
23+
"monikers": [
24+
"migrate"
25+
]
26+
},
27+
{
28+
"source_path": "articles/migrate/concepts-azure-sql-assessment-calculation.md",
29+
"redirect_url": "/previous-versions/azure/migrate/concepts-azure-sql-assessment-calculation",
30+
"redirect_document_id": false,
31+
"monikers": [
32+
"migrate"
33+
]
34+
},
35+
{
36+
"source_path": "articles/migrate/concepts-azure-vmware-solution-assessment-calculation.md",
37+
"redirect_url": "/previous-versions/azure/migrate/concepts-azure-vmware-solution-assessment-calculation",
38+
"redirect_document_id": false,
39+
"monikers": [
40+
"migrate"
41+
]
42+
},
43+
{
44+
"source_path": "articles/migrate/concepts-azure-webapps-assessment-calculation.md",
45+
"redirect_url": "/previous-versions/azure/migrate/concepts-azure-webapps-assessment-calculation",
46+
"redirect_document_id": false,
47+
"monikers": [
48+
"migrate"
49+
]
50+
},
51+
{
52+
"source_path": "articles/migrate/concepts-migration-planning.md",
53+
"redirect_url": "/previous-versions/azure/migrate/concepts-migration-planning",
54+
"redirect_document_id": false,
55+
"monikers": [
56+
"migrate"
57+
]
58+
},
59+
{
60+
"source_path": "articles/migrate/concepts-migration-webapps.md",
61+
"redirect_url": "/previous-versions/azure/migrate/concepts-migration-webapps",
62+
"redirect_document_id": false,
63+
"monikers": [
64+
"migrate"
65+
]
66+
},
67+
{
68+
"source_path": "articles/migrate/how-to-create-a-group.md",
69+
"redirect_url": "/previous-versions/azure/migrate/how-to-create-a-group",
70+
"redirect_document_id": false,
71+
"monikers": [
72+
"migrate"
73+
]
74+
},
75+
{
76+
"source_path": "articles/migrate/how-to-create-azure-app-service-assessment.md",
77+
"redirect_url": "/previous-versions/azure/migrate/how-to-create-azure-app-service-assessment",
78+
"redirect_document_id": false,
79+
"monikers": [
80+
"migrate"
81+
]
82+
},
83+
{
84+
"source_path": "articles/migrate/how-to-create-azure-sql-assessment.md",
85+
"redirect_url": "/previous-versions/azure/migrate/how-to-create-azure-sql-assessment",
86+
"redirect_document_id": false,
87+
"monikers": [
88+
"migrate"
89+
]
90+
},
91+
{
92+
"source_path": "articles/migrate/how-to-discover-applications.md",
93+
"redirect_url": "/previous-versions/azure/migrate/how-to-discover-applications",
94+
"redirect_document_id": false,
95+
"monikers": [
96+
"migrate"
97+
]
98+
},
99+
{
100+
"source_path": "articles/migrate/how-to-create-sql-assessment.md",
101+
"redirect_url": "/previous-versions/azure/migrate/how-to-create-sql-assessment",
102+
"redirect_document_id": false,
103+
"monikers": [
104+
"migrate"
105+
]
106+
},
107+
{
108+
"source_path": "articles/migrate/how-to-migrate.md",
109+
"redirect_url": "/previous-versions/azure/migrate/how-to-migrate",
110+
"redirect_document_id": false,
111+
"monikers": [
112+
"migrate"
113+
]
114+
},
115+
{
116+
"source_path": "articles/migrate/how-to-modify-assessment.md",
117+
"redirect_url": "/previous-versions/azure/migrate/how-to-modify-assessment",
118+
"redirect_document_id": false,
119+
"monikers": [
120+
"migrate"
121+
]
122+
},
123+
{
124+
"source_path": "articles/migrate/how-to-review-sql-assessment.md",
125+
"redirect_url": "/previous-versions/azure/migrate/how-to-review-sql-assessment",
126+
"redirect_document_id": false,
127+
"monikers": [
128+
"migrate"
129+
]
130+
},
131+
{
132+
"source_path": "articles/migrate/how-to-set-up-appliance-hyper-v.md",
133+
"redirect_url": "/previous-versions/azure/migrate/how-to-set-up-appliance-hyper-v",
134+
"redirect_document_id": false,
135+
"monikers": [
136+
"migrate"
137+
]
138+
},
139+
{
140+
"source_path": "articles/migrate/how-to-set-up-appliance-vmware.md",
141+
"redirect_url": "/previous-versions/azure/migrate/how-to-set-up-appliance-vmware",
142+
"redirect_document_id": false,
143+
"monikers": [
144+
"migrate"
145+
]
146+
},
147+
{
148+
"source_path": "articles/migrate/migrate-replication-appliance.md",
149+
"redirect_url": "/previous-versions/azure/migrate/migrate-replication-appliance",
150+
"redirect_document_id": false,
151+
"monikers": [
152+
"migrate"
153+
]
154+
},
155+
{
156+
"source_path": "articles/migrate/review-sap-assessment.md",
157+
"redirect_url": "/previous-versions/azure/migrate/review-sap-assessment",
158+
"redirect_document_id": false,
159+
"monikers": [
160+
"migrate"
161+
]
162+
},
163+
{
164+
"source_path": "articles/migrate/tutorial-assess-aspnet-aks.md",
165+
"redirect_url": "/previous-versions/azure/migrate/tutorial-assess-aspnet-aks",
166+
"redirect_document_id": false,
167+
"monikers": [
168+
"migrate"
169+
]
170+
},
171+
{
172+
"source_path": "articles/migrate/tutorial-assess-aws.md",
173+
"redirect_url": "/previous-versions/azure/migrate/tutorial-assess-aws",
174+
"redirect_document_id": false,
175+
"monikers": [
176+
"migrate"
177+
]
178+
},
179+
{
180+
"source_path": "articles/migrate/tutorial-assess-gcp.md",
181+
"redirect_url": "/previous-versions/azure/migrate/tutorial-assess-gcp",
182+
"redirect_document_id": false,
183+
"monikers": [
184+
"migrate"
185+
]
186+
},
187+
{
188+
"source_path": "articles/migrate/tutorial-assess-hyper-v.md",
189+
"redirect_url": "/previous-versions/azure/migrate/tutorial-assess-hyper-v",
190+
"redirect_document_id": false,
191+
"monikers": [
192+
"migrate"
193+
]
194+
},
195+
{
196+
"source_path": "articles/migrate/tutorial-assess-sap-systems.md",
197+
"redirect_url": "/previous-versions/azure/migrate/tutorial-assess-sap-systems",
198+
"redirect_document_id": false,
199+
"monikers": [
200+
"migrate"
201+
]
202+
},
203+
{
204+
"source_path": "articles/migrate/tutorial-assess-webapps.md",
205+
"redirect_url": "/previous-versions/azure/migrate/tutorial-assess-webapps",
206+
"redirect_document_id": false,
207+
"monikers": [
208+
"migrate"
209+
]
210+
},
211+
{
212+
"source_path": "articles/migrate/tutorial-discover-sap-systems.md",
213+
"redirect_url": "/previous-versions/azure/migrate/tutorial-discover-sap-systems",
214+
"redirect_document_id": false,
215+
"monikers": [
216+
"migrate"
217+
]
218+
},
219+
{
220+
"source_path": "articles/migrate/tutorial-migrate-gcp-virtual-machines.md",
221+
"redirect_url": "/previous-versions/azure/migrate/tutorial-migrate-gcp-virtual-machines",
222+
"redirect_document_id": false,
223+
"monikers": [
224+
"migrate"
225+
]
226+
},
227+
{
228+
"source_path": "articles/migrate/migrate-support-matrix-physical-migration.md",
229+
"redirect_url": "/previous-versions/azure/migrate/migrate-support-matrix-physical-migration",
230+
"redirect_document_id": false,
231+
"monikers": [
232+
"migrate"
233+
]
234+
},
3235
{
4236
"source_path": "articles/azure-functions/durable/durable-task-scheduler/durable-task-scheduler-dedicated-sku.md",
5237
"redirect_url": "/azure/azure-functions/durable/durable-task-scheduler/durable-task-scheduler-billing",
@@ -7056,6 +7288,11 @@
70567288
{
70577289
"source_path": "articles/virtual-network/virtual-network-troubleshoot-cannot-delete-vnet.md",
70587290
"redirect_url": "/troubleshoot/azure/virtual-network/virtual-network-troubleshoot-cannot-delete-vnet"
7059-
}
7291+
},
7292+
{
7293+
"source_path": "articles/certification/edge-secured-core-get-certified.md",
7294+
"redirect_url": "/azure/certification/requirements-edge-secured-core",
7295+
"redirect_document_id": false
7296+
},
70607297
]
70617298
}

0 commit comments

Comments
 (0)