Skip to content

Commit dc40c12

Browse files
authored
Merge pull request #1181 from MicrosoftDocs/main
4/22 main to live
2 parents d8eb950 + c50e70a commit dc40c12

5 files changed

Lines changed: 45 additions & 38 deletions

File tree

.openpublishing.redirection.json

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,11 @@
1111
"source_path": "Contribute/light-workflow.md",
1212
"redirect_url": "/"
1313
},
14+
{
15+
"source_path": "Contribute/content/dotnet/dotnet-contribute-code-analysis.md",
16+
"redirect_url": "/contribute/content/dotnet/code-analysis-rules",
17+
"redirect_document_id": true
18+
},
1419
{
1520
"source_path": "Contribute/dotnet-contribute-process.md",
1621
"redirect_url": "/contribute/dotnet/dotnet-contribute"
@@ -237,11 +242,11 @@
237242
"source_path": "ai-navigator/index.yml",
238243
"redirect_url": "/contribute/",
239244
"redirect_document_id": false
240-
},
245+
},
241246
{
242247
"source_path": "Contribute/content/architecture-center/solution-idea-templates.md",
243248
"redirect_url": "/contribute/content/architecture-center/aac-contribute",
244249
"redirect_document_id": false
245250
}
246251
]
247-
}
252+
}

CODEOWNERS

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,2 @@
11
# These owners will be the default owners for everything in the repo. Unless a later match takes precedence
2-
* @mikekinsman @jehchow @Kiranchandratrey @sgaspari815 @nickwalkmsft
2+
* @mikekinsman @jehchow @Kiranchandratrey @sgaspari815 @kcpitt

Contribute/content/TOC.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -102,7 +102,7 @@
102102
- name: Pull request review process
103103
href: dotnet/dotnet-pr-review.md
104104
- name: Code analysis docs
105-
href: dotnet/dotnet-contribute-code-analysis.md
105+
href: dotnet/code-analysis-rules.md
106106
- name: Patterns and Practices (AAC, WAF, CAF)
107107
href: architecture-center/aac-contribute.md
108108
- name: PowerShell-Docs

Contribute/content/dotnet/dotnet-contribute-code-analysis.md renamed to Contribute/content/dotnet/code-analysis-rules.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,29 +1,29 @@
11
---
2-
title: Contribute docs for .NET code analysis rules to the .NET docs repository
2+
title: Contribute docs for .NET code analysis rules
33
description: This article describes the process for contributing to the articles and code samples for .NET code analysis rules in the .NET docs repository.
44
author: mavasani
5-
ms.author: mavasani
5+
ms.author: gewarren
66
ms.topic: contributor-guide
77
ms.service: learn
88
ms.custom: external-contributor-guide
9-
ms.date: 06/17/2025
9+
ms.date: 03/17/2026
1010
---
11-
# Contribute docs for .NET code analysis rules to the .NET docs repository
11+
# Contribute docs for .NET code analysis rules
1212

13-
.NET compiler platform (Roslyn) analyzers inspect your C# or Visual Basic code for code quality and code style issues. Starting in .NET 5.0, these analyzers are [included with the .NET SDK](/dotnet/fundamentals/code-analysis/overview).
13+
.NET compiler platform (Roslyn) analyzers inspect your C# or Visual Basic code for code quality and code style issues. These analyzers are [included with the .NET SDK](/dotnet/fundamentals/code-analysis/overview).
1414

1515
- [Code quality analysis ("CAxxxx" rules)](/dotnet/fundamentals/code-analysis/overview#code-quality-analysis):
16-
- Implemented [here](https://github.com/dotnet/roslyn-analyzers/tree/main/src/NetAnalyzers) in `dotnet/roslyn-analyzers` repo.
16+
- Implemented in the [dotnet/sdk](https://github.com/dotnet/sdk/tree/main/src/Microsoft.CodeAnalysis.NetAnalyzers) repo (previously implemented in `dotnet/roslyn-analyzers` repo).
1717
- Documented [here](https://github.com/dotnet/docs/blob/main/docs/fundamentals/code-analysis/quality-rules) in the `dotnet/docs` repo. See [Contribute docs for 'CAxxxx' rules](#contribute-docs-for-caxxxx-rules).
1818
- [Code style analysis ("IDExxxx" rules)](/dotnet/fundamentals/code-analysis/overview#code-style-analysis):
19-
- Implemented [here](https://github.com/dotnet/roslyn/tree/main/src/Analyzers) in `dotnet/roslyn` repo.
19+
- Implemented in the [dotnet/roslyn](https://github.com/dotnet/roslyn/tree/main/src/Analyzers) repo.
2020
- Documented [here](https://github.com/dotnet/docs/blob/main/docs/fundamentals/code-analysis/style-rules) in the `dotnet/docs` repo. See [Contribute docs for 'IDExxxx' rules](#contribute-docs-for-idexxxx-rules).
2121

2222
## Contribute docs for 'CAxxxx' rules
2323

2424
Please follow the following steps to contribute documentation for code quality analysis rules to the [dotnet/docs](https://github.com/dotnet/docs) repo:
2525

26-
1. Determine `Rule ID` and `Category`: Ensure that you know the 'CAxxxx' rule ID and category for the rule to be documented. This means either your CA analyzer has been merged into [dotnet/roslyn-analyzers](https://github.com/dotnet/roslyn-analyzers) repo or you have an open PR with an approved ID and category that has been assigned to the rule.
26+
1. Determine `Rule ID` and `Category`: Ensure that you know the 'CAxxxx' rule ID and category for the rule to be documented. This means either your CA analyzer has been merged into the [dotnet/sdk](https://github.com/dotnet/sdk) repo or you have an open PR with an approved ID and category that has been assigned to the rule.
2727
2. Add rule doc:
2828
1. Clone an existing CA rule file under [root](https://github.com/dotnet/docs/blob/main/docs/fundamentals/code-analysis/quality-rules) folder, say `ca1000.md`, and rename it.
2929
2. Update the content of the file appropriately.

Contribute/index.yml

Lines changed: 28 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,7 @@
11
### YamlMime:Marketing
2-
### YamlMime:Marketing
32
title: 'Experts Hub'
43
metadata:
5-
title: 'Experts Hub: Share what you know. Shape whats next.'
4+
title: "Experts Hub: Share what you know. Shape what's next."
65
description: 'Share your knowledge with the world as a Microsoft expert!'
76
sections:
87
# hero with background image
@@ -16,7 +15,7 @@ sections:
1615
src: media/experts-hub-long-format-400.png
1716
# top navigation links
1817
- componentType: navigation
19-
size: large
18+
size: large
2019
alignment: center
2120
blocks:
2221
- componentType: icon-link
@@ -39,7 +38,7 @@ sections:
3938
questions:
4039
- question: Overview of this section
4140
answer: |
42-
This section highlights highinterest topics your audience is already searching for and talking about. Think of these as prime opportunities to create content that stands out and attracts learners who are actively looking for guidance.
41+
This section highlights high-interest topics your audience is already searching for and talking about. Think of these as prime opportunities to create content that stands out and attracts learners who are actively looking for guidance.
4342
4443
If a topic aligns with your expertise, jump in and turn it into content that showcases your voice and point of view. You might:
4544
@@ -53,26 +52,29 @@ sections:
5352
answer: |
5453
Grow your reputation on Microsoft Q&A by providing expert insights, clarification, and solutions on these trending topics:
5554
56-
- There's interest in understanding the differences between [Developer Command Prompt and Developer PowerShell in Visual Studio](https://learn.microsoft.com/answers/questions/5722678/what-are-the-different-between-developer-command-p).
57-
- Help Azure users [understand error codes](https://learn.microsoft.com/answers/questions/5562339/error-code-5000225-message-this-tenant-has-been-bl) related to managing [tenant lifecycles in Microsoft Entra](https://learn.microsoft.com/entra/fundamentals/inaccessible-tenant).
58-
- Learners want to understand how to use agents created from templates in Copilot Studio, such as the [Customer Insight template agent](https://learn.microsoft.com/answers/questions/5527396/an-agent-created-through-co-pilot-studio-is-not-ab).
59-
- question: 'Updates and tools for AI builders in Microsoft Foundry'
55+
- A Copilot user is seeing [link generation issues in Excel](https://learn.microsoft.com/answers/questions/5707555/excel-copilot-is-generating-download-links-that-ha).
56+
- Help a user solve [conditional Access challenges](https://learn.microsoft.com/answers/questions/5602614/entra-conditional-access-issue) with Entra.
57+
- Visual Studio users want to [resolve high memory usage issues](https://learn.microsoft.com/answers/questions/5744593/visual-studio-2026-uses-excessive-memory-(20gb-)-w).
58+
- question: Copilot Cowork
59+
answer: |
60+
Copilot Cowork is a new capability in Microsoft 365 Copilot, now available to users in the [Frontier program](https://www.microsoft.com/microsoft-365/blog/2026/03/30/copilot-cowork-now-available-in-frontier/?msockid=0494b01f33f86ff500b3a51332d56e84). It plans and carries out multi‑step tasks across emails, meetings, files, and apps, rather than only returning responses. It executes work through an explicit plan with checkpoints and approvals, allowing tasks to run while remaining within M365’s existing security and governance boundaries. Check out the following resources to help you share Cowork with your audiences:
61+
- Read the [announcement post](https://www.microsoft.com/microsoft-365/blog/2026/03/09/copilot-cowork-a-new-way-of-getting-work-done/?msockid=0494b01f33f86ff500b3a51332d56e84) introducing Copilot Cowork and describing how it enables Copilot to plan and execute tasks across M365.
62+
- Check out a [short demo](https://www.youtube.com/watch?v=j8rHJsM3fxQ) of Copilot Cowork in action, including planning a [product launch and associated assets](https://www.youtube.com/watch?v=9uRuf7nB4cg)
63+
- question: Azure migration resources
6064
answer: |
61-
- [Claude Opus 4.6 is now in Microsoft Foundry](https://azure.microsoft.com/en-us/blog/claude-opus-4-6-anthropics-powerful-model-for-coding-agents-and-enterprise-workflows-is-now-available-in-microsoft-foundry-on-azure/), enabling advanced reasoning for AI agents acting on business systems.
62-
- For healthcare and life sciences applications, see [Claude's specialized capabilities with Foundry](https://www.microsoft.com/en-us/industry/blog/healthcare/2026/01/11/bridging-the-gap-between-ai-and-medicine-claude-in-microsoft-foundry-advances-capabilities-for-healthcare-and-life-sciences-customers/).
63-
- Explore the [catalog of AI models from Foundry](https://ai.azure.com/catalog/models) and documentation on [Foundry Models sold directly by Azure](https://learn.microsoft.com/en-us/azure/ai-foundry/foundry-models/concepts/models-sold-directly-by-azure?view=foundry-classic&tabs=global-standard-aoai%2Cglobal-standard&pivots=azure-openai). Audiences want to understand how to leverage these models in their AI solutions.
64-
- Check out a hands-on way to improve security posture and build customer trust in an agentic AI solution with [the AI Red Teaming agent in Microsoft Foundry](https://github.com/microsoft/aitour26-LTG156-safeguard-agentic-ai-solutions-with-ai-red-teaming-agent).
65-
- question: Azure updates for developers
65+
- This [Virtual Training Day session](https://www.youtube.com/watch?v=WaVISr34SSM) provides a detailed foundation to help audiences understand best practices for migrating and modernizing on Azure.
66+
- For more scenario-specific and troubleshooting content, check out [this blog post on migration challenges and solutions](https://techcommunity.microsoft.com/blog/itopstalkblog/azure-migration-challenges-and-how-to-resolve-them/4499618).
67+
- question: GitHub Copilot CLI
6668
answer: |
67-
- Developer audiences are interested in building and remotely hosting MCP servers. [This episode](https://learn.microsoft.com/shows/azure-friday/host-remote-mcp-servers-on-azure-functions), led by Scott Hanselman and Lily Ma, demonstrates how to remotely host MCP servers on Azure Functions with official MCP SDKs.
68-
- Explore a [deep dive into the AKS MCP Server & Agentic CLI](https://www.youtube.com/watch?v=tEPfxO1FEMk) in January's AKS community call.
69-
- As more audiences build AI agents, they're looking to improve cost efficiency on Azure. [This learning path on maximizing AI agent ROI](https://learn.microsoft.com/training/paths/maximize-cost-efficiency-ai-agents/) offers strategies for cost-conscious decisions, ROI forecasting, and scalable architectures to optimize investments on Azure.
70-
- question: AI for all levels of .NET developers
69+
Copilot CLI is a command‑line interface that brings Copilot assistance directly into the terminal, enabling developers to generate commands, scripts, and explanations using natural language. It’s designed to help developers work faster in the CLI without switching context to an editor or chat interface.
70+
- Check out an [open-source, hands-on course](https://github.com/github/copilot-cli-for-beginners)
71+
- See video demos and additional beginner tutorials in a [YouTube playlist created by GitHub](https://www.youtube.com/watch?v=BDxRhhs36ns&list=PL0lo9MOBetEHvO-spzKBAITkkTqv4RvNl)
72+
- question: 'New: Agent Governance Toolkit'
7173
answer: |
72-
Help .NET developers across multiple skill levels understand the foundations and opportunities for leveraging AI in their applications.
73-
- [Hands-on course](https://github.com/microsoft/Generative-AI-for-beginners-dotnet) and [accompanying video series](https://www.youtube.com/playlist?list=PLdo4fOcmZ0oUkPkWy9EtmBvFAjfp4ZHnx) on Generative AI fundamentals with .NET.
74-
- [Video overview of modernizing .NET apps with GitHub Copilot](https://www.youtube.com/watch?v=-YKguff5GY8).
75-
- [Workshop for .NET developers](https://github.com/Azure-Samples/modernize-monolith-workshop) looking for hands‑on experience modernizing a legacy .NET Framework monolith using AI‑powered tools and GitHub Copilot agents.
74+
In April, Microsoft announced the Agent Governance Toolkit, a new, open-source runtime security toolkit designed to help agent builders govern what agents do at execution in the tools they already work with. It was released under the Microsoft organization and MIT license, is framework-agnostic, and aligns to the OWASP Agentic AI Top 10.
75+
- Review the announcement of the launch of the [Agent Governance Toolkit](https://opensource.microsoft.com/blog/2026/04/02/introducing-the-agent-governance-toolkit-open-source-runtime-security-for-ai-agents/).
76+
- Dive into the full toolkit in [the open-source GitHub repo](https://github.com/microsoft/agent-governance-toolkit).
77+
- Explore [Microsoft Agent Framework(MAF)](https://learn.microsoft.com/agent-framework/overview/?pivots=programming-language-csharp) to learn more about Microsoft's framework for building and orchestrating agents. The Agent Governance Toolkit can be used alongside MAF and other services.
7678
7779
# bifold with image and text blocks
7880
- componentType: bifold
@@ -82,7 +84,7 @@ sections:
8284
alt: A GitHub Copilot chat interaction with the Microsoft Learn MCP Server
8385
componentType: image
8486
- title: Content creation resources for the Microsoft Learn MCP Server
85-
summary: A set of ready-to-use assets to help you accurately present, demo, and share the Microsoft Learn MCP Server with your audience.
87+
summary: A set of ready-to-use assets to help you accurately present, demo, and share the Microsoft Learn MCP Server with your audience.
8688
componentType: text
8789
links:
8890
- componentType: link
@@ -184,7 +186,7 @@ sections:
184186
title: Impactful opportunities happening now
185187
blocks:
186188
- componentType: summary-card
187-
title: Contribute to awesome-azd
189+
title: Contribute to awesome-azd
188190
summary: Share templates for using the Azure Developer CLI (azd) by contributing to the awesome-azd collection.
189191
url: https://github.com/azure/awesome-azd
190192
- componentType: summary-card
@@ -193,7 +195,7 @@ sections:
193195
url: https://github.com/github/awesome-copilot
194196
- componentType: summary-card
195197
title: Join the Azure AI Foundry Discord community
196-
summary: Join the Azure AI Foundry community to share your knowledge and connect with other AI experts and learners.
198+
summary: Join the Azure AI Foundry community to share your knowledge and connect with other AI experts and learners.
197199
url: https://discord.com/invite/microsoftfoundry
198200
- componentType: summary-card
199201
title: Agent Creators
@@ -260,7 +262,7 @@ sections:
260262
title: Connect with us
261263
links:
262264
- componentType: social-link
263-
url: https://twitter.com/MicrosoftLearn
265+
url: https://twitter.com/MicrosoftLearn
264266
destination: twitter
265267
- componentType: social-link
266268
url: https://www.linkedin.com/showcase/microsoftlearn/
@@ -269,5 +271,5 @@ sections:
269271
url: https://www.tiktok.com/@microsoftlearn
270272
destination: website
271273
- componentType: social-link
272-
url: https://aka.ms/MicrosoftLearnNewsletter
274+
url: https://aka.ms/MicrosoftLearnNewsletter
273275
destination: website

0 commit comments

Comments
 (0)