Skip to content

Commit f6fe6d0

Browse files
authored
Merge branch 'main' into article-refresh-lines-nb-71-85
2 parents f5eaf78 + fdcd290 commit f6fe6d0

14,086 files changed

Lines changed: 345662 additions & 328728 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: 114 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,42 @@
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+
},
293+
{
294+
"path_to_root": "functions-event-hub-azd-dotnet",
295+
"url": "https://github.com/Azure-Samples/functions-quickstart-dotnet-azd-eventhub",
296+
"branch": "main",
297+
"branch_mapping": {}
298+
},
299+
{
300+
"path_to_root": "functions-event-hub-azd-typescript",
301+
"url": "https://github.com/Azure-Samples/functions-quickstart-typescript-azd-eventhub",
302+
"branch": "main",
303+
"branch_mapping": {}
304+
},
305+
{
306+
"path_to_root": "functions-event-hub-azd-python",
307+
"url": "https://github.com/Azure-Samples/functions-quickstart-python-azd-eventhub",
308+
"branch": "main",
309+
"branch_mapping": {}
310+
},
251311
{
252312
"path_to_root": "azure-functions-templates-v3",
253313
"url": "https://github.com/Azure/azure-functions-templates",
@@ -470,6 +530,18 @@
470530
"branch": "dev",
471531
"branch_mapping": {}
472532
},
533+
{
534+
"path_to_root": "functions-nodejs-extensions",
535+
"url": "https://github.com/Azure/azure-functions-nodejs-extensions",
536+
"branch": "main",
537+
"branch_mapping": {}
538+
},
539+
{
540+
"path_to_root": "functions-node-sdk-bindings-blob",
541+
"url": "https://github.com/Azure-Samples/azure-functions-blob-sdk-bindings-nodejs",
542+
"branch": "main",
543+
"branch_mapping": {}
544+
},
473545
{
474546
"path_to_root": "functions-python-tensorflow-tutorial",
475547
"url": "https://github.com/Azure-Samples/functions-python-tensorflow-tutorial",
@@ -507,11 +579,51 @@
507579
"branch_mapping": {}
508580
},
509581
{
510-
"path_to_root": "functions-sql-todo-sample",
582+
"path_to_root": "functions-scenarios-durable-dotnet",
583+
"url": "https://github.com/Azure-Samples/durable-functions-quickstart-dotnet-azd",
584+
"branch": "main",
585+
"branch_mapping": {}
586+
},
587+
{
588+
"path_to_root": "functions-scenarios-durable-typescript",
589+
"url": "https://github.com/Azure-Samples/durable-functions-quickstart-typescript-azd",
590+
"branch": "main",
591+
"branch_mapping": {}
592+
},
593+
{
594+
"path_to_root": "functions-scenarios-durable-python",
595+
"url": "https://github.com/Azure-Samples/durable-functions-quickstart-python-azd",
596+
"branch": "main",
597+
"branch_mapping": {}
598+
},
599+
{ "path_to_root": "functions-sql-todo-sample",
511600
"url": "https://github.com/Azure-Samples/azure-sql-binding-func-dotnet-todo",
512601
"branch": "docs-snippets",
513602
"branch_mapping": {}
514603
},
604+
{
605+
"path_to_root": "functions-scenarios-custom-mcp-dotnet",
606+
"url": "https://github.com/Azure-Samples/remote-mcp-functions-dotnet",
607+
"branch": "main",
608+
"branch_mapping": {}
609+
},
610+
{
611+
"path_to_root": "functions-scenarios-custom-mcp-python",
612+
"url": "https://github.com/Azure-Samples/remote-mcp-functions-python",
613+
"branch": "main",
614+
"branch_mapping": {}
615+
},
616+
{
617+
"path_to_root": "functions-scenarios-custom-mcp-java",
618+
"url": "https://github.com/Azure-Samples/remote-mcp-functions-java",
619+
"branch": "main",
620+
"branch_mapping": {}
621+
}, {
622+
"path_to_root": "functions-scenarios-custom-mcp-typescript",
623+
"url": "https://github.com/Azure-Samples/remote-mcp-functions-typescript",
624+
"branch": "main",
625+
"branch_mapping": {}
626+
},
515627
{
516628
"path_to_root": "ImmersiveReaderSdk",
517629
"url": "https://github.com/microsoft/immersive-reader-sdk",
@@ -746,12 +858,6 @@
746858
"branch": "tutorial",
747859
"branch_mapping": {}
748860
},
749-
{
750-
"path_to_root": "samples-tsi",
751-
"url": "https://github.com/Azure-Samples/Azure-Time-Series-Insights",
752-
"branch": "master",
753-
"branch_mapping": {}
754-
},
755861
{
756862
"path_to_root": "storage-mgmt-devguide-dotnet",
757863
"url": "https://github.com/Azure-Samples/storage-mgmt-devguide-dotnet",

0 commit comments

Comments
 (0)