Skip to content

Commit c526786

Browse files
authored
Merge branch 'main' into vc-toc-email-updates-2025-02-14
2 parents de4e435 + 5f2005a commit c526786

File tree

1,127 files changed

+11753
-7197
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

1,127 files changed

+11753
-7197
lines changed

.github/policies/disallow-edits.yml

Lines changed: 71 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ configuration:
1010
- payloadType: Pull_Request
1111
- isAction:
1212
action: Opened
13-
- or:
13+
- or:
1414
- filesMatchPattern:
1515
matchAny: true
1616
pattern: articles/aks/*
@@ -121,4 +121,74 @@ configuration:
121121
reply: >-
122122
@${issueAuthor} - You tried to add content to a folder path that has been removed from this repository. Your pull request will be automatically closed. Submit your changes to the updated repository, which can be identified by clicking the Edit this Document link at the top of any published article for that product or service.
123123
- closePullRequest
124+
125+
- description: Alert authors to edits in the /articles/reliability folder.
126+
if:
127+
# If a PR in the articles/reliability folder is opened, and the PR author isn't Anastasia or John...
128+
- payloadType: Pull_Request
129+
- filesMatchPattern:
130+
matchAny: true
131+
pattern: articles/reliability/*
132+
- isAction:
133+
action: Opened
134+
- not:
135+
or:
136+
- isActivitySender:
137+
user: anaharris-ms
138+
- isActivitySender:
139+
user: johndowns
140+
then:
141+
# Mention Anastasia and John, add a reply asking the PR author not to sign off on the PR, and add the needs-human-review label.
142+
- mentionUsers:
143+
mentionees:
144+
- anaharris-ms
145+
- johndowns
146+
replyTemplate: >-
147+
Tagging authors for this folder: ${mentionees}
148+
- addReply:
149+
reply: >-
150+
@${issueAuthor} - Please do NOT sign off on this pull request. The Reliability Hub owners will sign off for you.
151+
- addLabel:
152+
label: needs-human-review
153+
154+
- description: Disallow sign-off for articles in the /articles/reliability folder.
155+
if:
156+
# If a 'sign-off' comment is added to a PR in the articles/reliability folder , and the PR author isn't Anastasia or John...
157+
- payloadType: Issue_Comment
158+
- isPullRequest
159+
- filesMatchPattern:
160+
matchAny: true
161+
pattern: articles/reliability/*
162+
- commentContains:
163+
pattern: \#sign-off
164+
isRegex: false
165+
- not:
166+
or:
167+
- isActivitySender:
168+
user: anaharris-ms
169+
- isActivitySender:
170+
user: johndowns
171+
then:
172+
# Add the do-not-merge label, remove the ready-to-merge label, and add a reply asking the PR author not to sign off on the PR.
173+
- addReply:
174+
reply: >-
175+
@${issueAuthor} - Please do NOT sign off on this pull request. The Reliability Hub owners will sign off for you.
176+
- addLabel:
177+
label: do-not-merge
178+
- removeLabel:
179+
label: ready-to-merge
180+
181+
- description: Write a message if the breadcrumb file is modified in the azure-docs-pr repository.
182+
if:
183+
- payloadType: Pull_Request
184+
- isAction:
185+
action: Opened
186+
- filesMatchPattern:
187+
matchAny: true
188+
pattern: bread/*
189+
190+
then:
191+
- addReply:
192+
reply: >-
193+
@${issueAuthor} - This PR modifies the breadcrumb file for the entire repository in this pull request; the breadcrumb supports 100s of services. Please make sure your changes to the breadcrumb file are intentional. Do not delete this file.
124194

.openpublishing.redirection.json

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5244,6 +5244,11 @@
52445244
"redirect_url": "/azure/virtual-wan/virtual-wan-about",
52455245
"redirect_document_id": false
52465246
},
5247+
{
5248+
"source_path_from_root": "/articles/virtual-wan/openvpn-azure-ad-client.md",
5249+
"redirect_url": "/azure/virtual-wan/point-to-site-entra-vpn-client-windows",
5250+
"redirect_document_id": false
5251+
},
52475252
{
52485253
"source_path_from_root": "/articles/virtual-wan/high-availability-vpn-client.md",
52495254
"redirect_url": "/azure/virtual-wan/global-hub-profile",
@@ -5259,6 +5264,11 @@
52595264
"redirect_url": "/azure/virtual-wan/monitor-virtual-wan",
52605265
"redirect_document_id": false
52615266
},
5267+
{
5268+
"source_path_from_root": "/articles/virtual-wan/openvpn-azure-ad-client-mac.md",
5269+
"redirect_url": "/azure/virtual-wan/point-to-site-entra-vpn-client-mac",
5270+
"redirect_document_id": false
5271+
},
52625272
{
52635273
"source_path_from_root": "/articles/virtual-wan/monitoring-best-practices.md",
52645274
"redirect_url": "/azure/virtual-wan/monitor-virtual-wan",
@@ -5923,6 +5933,16 @@
59235933
"source_path_from_root": "/articles/reliability/reliability-hdinsight-on-aks.md",
59245934
"redirect_url": "/azure/reliability/overview-reliability-guidance",
59255935
"redirect_document_id": false
5936+
},
5937+
{
5938+
"source_path_from_root": "/articles/managed-grafana/concept-role-based-access-control.md",
5939+
"redirect_url": "/azure/managed-grafana/how-to-manage-access-permissions-users-identities",
5940+
"redirect_document_id": false
5941+
},
5942+
{
5943+
"source_path_from_root": "/articles/managed-grafana/how-to-share-grafana-workspace.md",
5944+
"redirect_url": "/azure/managed-grafana/how-to-manage-access-permissions-users-identities",
5945+
"redirect_document_id": false
59265946
}
59275947
]
59285948
}
4.69 KB
Loading
-1.99 KB
Loading
-3.33 KB
Loading
-10.3 KB
Loading
23.9 KB
Loading
-36.1 KB
Loading

articles/api-center/TOC.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -46,6 +46,8 @@
4646
href: synchronize-aws-gateway-apis.md
4747
- name: Build and register APIs - VS Code extension
4848
href: build-register-apis-vscode-extension.md
49+
- name: Design and develop APIs - GitHub Copilot for Azure
50+
href: design-api-github-copilot-azure.md
4951
- name: Register APIs - GitHub Actions
5052
href: register-apis-github-actions.md
5153
- name: API governance

articles/api-center/build-register-apis-vscode-extension.md

Lines changed: 2 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,6 @@ API producer developers in your organization can build and register APIs in your
1717

1818
* Add an existing API to an API center as a one-time operation, or integrate a development pipeline to register APIs as part of a CI/CD workflow.
1919
* Use GitHub Copilot to generate new OpenAPI specs from API code.
20-
* Use natural language prompts with the API Center plugin for GitHub Copilot for Azure to create new OpenAPI specs.
2120

2221
API consumer developers can also take advantage of features in the extension to [discover and consume APIs](discover-apis-vscode-extension.md) in the API center and ensure [API governance](govern-apis-vscode-extension.md).
2322

@@ -28,7 +27,6 @@ The following Visual Studio Code extensions are needed for the specified scenari
2827
* [GitHub Actions](https://marketplace.visualstudio.com/items?itemName=GitHub.vscode-github-actions) - to register APIs using a CI/CD pipeline with GitHub Actions
2928
* [Azure Pipelines](https://marketplace.visualstudio.com/items?itemName=ms-azure-devops.azure-pipelines) - to register APIs using a CI/CD pipeline with Azure Pipelines
3029
* [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) - to generate OpenAPI specification files from API code
31-
* [GitHub Copilot for Azure](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azure-github-copilot) - to generate OpenAPI specification files using the Azure API Center Plugin for [GitHub Copilot for Azure](/azure/developer/github-copilot-azure/introduction) (preview)
3230

3331
[!INCLUDE [vscode-extension-setup](includes/vscode-extension-setup.md)]
3432

@@ -64,33 +62,8 @@ Use the power of [GitHub Copilot](https://marketplace.visualstudio.com/items?ite
6462

6563
After generating the OpenAPI specification file and checking for accuracy, you can register the API with your API center using the **Azure API Center: Register API** command.
6664

67-
## Generate OpenAPI spec using natural language prompts
68-
69-
The API Center plugin for [GitHub Copilot for Azure](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azure-github-copilot) (preview) helps you design new APIs starting from natural language prompts. With AI assistance, quickly generate an OpenAPI spec for API development that complies with your organization's standards.
70-
71-
> [!NOTE]
72-
> This feature is available in the pre-release version of the API Center extension.
73-
74-
1. If desired, set an active API style guide. Use the **Ctrl+Shift+P** keyboard shortcut to open the Command Palette. Type **Azure API Center: Set API Style Guide**, make a selection, and hit **Enter**.
75-
76-
If no style guide is set, the default `spectral:oas` ruleset is used.
77-
1. In the chat panel, make a request in natural language to the `@azure` agent to describe what the API does. Example:
78-
79-
```vscode
80-
@azure Generate OpenAPI spec: An API that allows customers to pay for an order using various payment methods such as cash, checks, credit cards, and debit cards.
81-
```
82-
83-
The agent responds with an OpenAPI specification document.
84-
85-
:::image type="content" source="media/build-register-apis-vscode-extension/generate-api-specification.png" alt-text="Screenshot showing how to use @azure extension to generate an OpenAPI spec from a prompt.":::
86-
87-
88-
1. Review the generated output for accuracy and compliance with your API style guide. Refine the prompt if needed to regenerate.
89-
90-
> [!TIP]
91-
> Effective prompts focus on an API's business requirements rather than implementation details. Shorter prompts sometimes work better than longer ones.
92-
1. When it meets your requirements, save the generated OpenAPI specification to a file.
93-
1. Register the API with your API center. Select **Register your API in API Center** button in the chat panel, or select **Azure API Center: Register API** from the Command Palette, and follow the prompts.
65+
> [!TIP]
66+
> API developers can also generate new OpenAPI specs using natural language prompts with the API Center plugin for GitHub Copilot for Azure. [Learn more](design-api-github-copilot-azure.md).
9467
9568
## Related content
9669

0 commit comments

Comments
 (0)