Skip to content

Commit 09592f6

Browse files
committed
Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into Freshness
2 parents 2eced52 + f77417f commit 09592f6

21,945 files changed

Lines changed: 452900 additions & 567326 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.
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.publish.config.json

Lines changed: 120 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -70,7 +70,7 @@
7070
},
7171
{
7272
"path_to_root": "azure_cli_scripts",
73-
"url": "https://github.com/ggailey777/azure-cli-samples",
73+
"url": "https://github.com/Azure-Samples/azure-cli-samples",
7474
"branch": "master",
7575
"branch_mapping": {}
7676
},
@@ -164,6 +164,24 @@
164164
"branch": "main",
165165
"branch_mapping": {}
166166
},
167+
{
168+
"path_to_root": "functions-host-mcp-sdk-dotnet",
169+
"url": "https://github.com/Azure-Samples/mcp-sdk-functions-hosting-dotnet",
170+
"branch": "main",
171+
"branch_mapping": {}
172+
},
173+
{
174+
"path_to_root": "functions-host-mcp-sdk-node",
175+
"url": "https://github.com/Azure-Samples/mcp-sdk-functions-hosting-node",
176+
"branch": "main",
177+
"branch_mapping": {}
178+
},
179+
{
180+
"path_to_root": "functions-host-mcp-sdk-python",
181+
"url": "https://github.com/Azure-Samples/mcp-sdk-functions-hosting-python",
182+
"branch": "main",
183+
"branch_mapping": {}
184+
},
167185
{
168186
"path_to_root": "azure-functions-durable-js",
169187
"url": "https://github.com/Azure/azure-functions-durable-js",
@@ -218,6 +236,12 @@
218236
"branch": "main",
219237
"branch_mapping": {}
220238
},
239+
{
240+
"path_to_root": "functions-flex-azure-files-samples",
241+
"url": "https://github.com/Azure-Samples/Azure-Functions-Flex-Consumption-with-Azure-Files-OS-Mount-Samples",
242+
"branch": "main",
243+
"branch_mapping": {}
244+
},
221245
{
222246
"path_to_root": "functions-quickstart-java-azd",
223247
"url": "https://github.com/Azure-Samples/azure-functions-java-flex-consumption-azd",
@@ -248,6 +272,24 @@
248272
"branch": "main",
249273
"branch_mapping": {}
250274
},
275+
{
276+
"path_to_root": "functions-azd-timer-dotnet",
277+
"url": "https://github.com/Azure-Samples/functions-quickstart-dotnet-azd-timer",
278+
"branch": "main",
279+
"branch_mapping": {}
280+
},
281+
{
282+
"path_to_root": "functions-azd-timer-python",
283+
"url": "https://github.com/Azure-Samples/functions-quickstart-python-azd-timer",
284+
"branch": "main",
285+
"branch_mapping": {}
286+
},
287+
{
288+
"path_to_root": "functions-azd-timer-typescript",
289+
"url": "https://github.com/Azure-Samples/functions-quickstart-typescript-azd-timer",
290+
"branch": "main",
291+
"branch_mapping": {}
292+
},
251293
{
252294
"path_to_root": "azure-functions-templates-v3",
253295
"url": "https://github.com/Azure/azure-functions-templates",
@@ -470,6 +512,18 @@
470512
"branch": "dev",
471513
"branch_mapping": {}
472514
},
515+
{
516+
"path_to_root": "functions-nodejs-extensions",
517+
"url": "https://github.com/Azure/azure-functions-nodejs-extensions",
518+
"branch": "main",
519+
"branch_mapping": {}
520+
},
521+
{
522+
"path_to_root": "functions-node-sdk-bindings-blob",
523+
"url": "https://github.com/Azure-Samples/azure-functions-blob-sdk-bindings-nodejs",
524+
"branch": "main",
525+
"branch_mapping": {}
526+
},
473527
{
474528
"path_to_root": "functions-python-tensorflow-tutorial",
475529
"url": "https://github.com/Azure-Samples/functions-python-tensorflow-tutorial",
@@ -501,11 +555,57 @@
501555
"branch_mapping": {}
502556
},
503557
{
504-
"path_to_root": "functions-sql-todo-sample",
558+
"path_to_root": "functions-scenarios-quickstart-sql",
559+
"url": "https://github.com/Azure-Samples/functions-quickstart-dotnet-azd-sql",
560+
"branch": "main",
561+
"branch_mapping": {}
562+
},
563+
{
564+
"path_to_root": "functions-scenarios-durable-dotnet",
565+
"url": "https://github.com/Azure-Samples/durable-functions-quickstart-dotnet-azd",
566+
"branch": "main",
567+
"branch_mapping": {}
568+
},
569+
{
570+
"path_to_root": "functions-scenarios-durable-typescript",
571+
"url": "https://github.com/Azure-Samples/durable-functions-quickstart-typescript-azd",
572+
"branch": "main",
573+
"branch_mapping": {}
574+
},
575+
{
576+
"path_to_root": "functions-scenarios-durable-python",
577+
"url": "https://github.com/Azure-Samples/durable-functions-quickstart-python-azd",
578+
"branch": "main",
579+
"branch_mapping": {}
580+
},
581+
{ "path_to_root": "functions-sql-todo-sample",
505582
"url": "https://github.com/Azure-Samples/azure-sql-binding-func-dotnet-todo",
506583
"branch": "docs-snippets",
507584
"branch_mapping": {}
508585
},
586+
{
587+
"path_to_root": "functions-scenarios-custom-mcp-dotnet",
588+
"url": "https://github.com/Azure-Samples/remote-mcp-functions-dotnet",
589+
"branch": "main",
590+
"branch_mapping": {}
591+
},
592+
{
593+
"path_to_root": "functions-scenarios-custom-mcp-python",
594+
"url": "https://github.com/Azure-Samples/remote-mcp-functions-python",
595+
"branch": "main",
596+
"branch_mapping": {}
597+
},
598+
{
599+
"path_to_root": "functions-scenarios-custom-mcp-java",
600+
"url": "https://github.com/Azure-Samples/remote-mcp-functions-java",
601+
"branch": "main",
602+
"branch_mapping": {}
603+
}, {
604+
"path_to_root": "functions-scenarios-custom-mcp-typescript",
605+
"url": "https://github.com/Azure-Samples/remote-mcp-functions-typescript",
606+
"branch": "main",
607+
"branch_mapping": {}
608+
},
509609
{
510610
"path_to_root": "ImmersiveReaderSdk",
511611
"url": "https://github.com/microsoft/immersive-reader-sdk",
@@ -626,12 +726,30 @@
626726
"branch": "main",
627727
"branch_mapping": {}
628728
},
729+
{
730+
"path_to_root": "app-service-agentic-langgraph-foundry-node",
731+
"url": "https://github.com/Azure-Samples/app-service-agentic-langgraph-foundry-node",
732+
"branch": "main",
733+
"branch_mapping": {}
734+
},
735+
{
736+
"path_to_root": "app-service-agentic-langgraph-foundry-python",
737+
"url": "https://github.com/Azure-Samples/app-service-agentic-langgraph-foundry-python",
738+
"branch": "main",
739+
"branch_mapping": {}
740+
},
629741
{
630742
"path_to_root": "app-service-agentic-semantic-kernel-java",
631743
"url": "https://github.com/Azure-Samples/app-service-agentic-semantic-kernel-java",
632744
"branch": "main",
633745
"branch_mapping": {}
634746
},
747+
{
748+
"path_to_root": "playwright-workspaces",
749+
"url": "https://github.com/Azure/playwright-workspaces",
750+
"branch": "main",
751+
"branch_mapping": {}
752+
},
635753
{
636754
"path_to_root": "playwright-testing-service",
637755
"url": "https://github.com/microsoft/playwright-testing-service",
@@ -722,12 +840,6 @@
722840
"branch": "tutorial",
723841
"branch_mapping": {}
724842
},
725-
{
726-
"path_to_root": "samples-tsi",
727-
"url": "https://github.com/Azure-Samples/Azure-Time-Series-Insights",
728-
"branch": "master",
729-
"branch_mapping": {}
730-
},
731843
{
732844
"path_to_root": "storage-mgmt-devguide-dotnet",
733845
"url": "https://github.com/Azure-Samples/storage-mgmt-devguide-dotnet",

0 commit comments

Comments
 (0)