[WIP] Docs - GitHub Copilot App Modernization for .NET

docs/azure/migration/appmod/faq.md

@@ -0,0 +1,30 @@
+---
+title: GitHub Copilot App Modernization for .NET FAQ
+description: Frequently asked questions for the GitHub Copilot App Modernization for .NET
+ms.topic: concept-article
+ms.date: 07/03/2025
+---
+
+# Frequently asked questions
+
+This page answers some of the most common questions about the GitHub Copilot App Modernization for .NET tool.
+
+### What is GitHub Copilot App Modernization for .NET ?
+
+GitHub Copilot App Modernization for .NET aims to help enterprises migrate their .NET applications to Azure with confidence and efficiency, covering assessment, code remediation and validation, powered by the intelligence of GitHub Copilot.
+
+Assessment of modernization issues
+- App modernization for .NET evaluates the readiness of developer's application for migration to Azure, with an interactive experience on Visual Studio, powered by AppCAT for .NET.
+
+Solution recommendations
+- App modernization for .NET recommends target Azure services for the resource dependencies of developer's application, for each category of assessed issues.
+
+Code remediation for common issues
+- To accelerate code changes for common modernization issues, the developer may apply predefined tasks that represent best practices from Microsoft.
+
+Automatic fix for compilation errors
+- After applying tasks, app modernization for .NET will automatically find and fix compilation errors introduced by the code changes.
+
+### Which Visual Studio version should I use?
+
+Please upgrade Visual Studio to the latest version to have better experience on both GitHub Copilot and App Modernization for .NET.

docs/azure/migration/appmod/overview.md

@@ -0,0 +1,62 @@
+# What is GitHub Copilot App Modernization for .NET?
+
+GitHub Copilot App Modernization for .NET aims to help enterprises migrate their .NET applications to Azure with confidence and efficiency, covering assessment, code remediation and validation, powered by the intelligence of GitHub Copilot.
+
+## Assessment of modernization issues
+
+App Modernization for .NET evaluates the readiness of developer's applications for migration to Azure, with an interactive experience on Visual Studio, powered by [AppCAT for .NET](../appcat/install.md).
+
+![Assessment](to_do_update_screenshot)
+
+## Solution recommendations
+
+App modernization for .NET recommends target Azure services for the resource dependencies of developer's application, for each category of assessed issues.
+
+![Solution](to_do_update_screenshot)
+
+## Code remediation for common issues
+To accelerate code changes for [common modernization issues](predefined-tasks.md), the developer may apply predefined tasks (code change patterns) that represent best practices from experts.
+
+![Apply Task](to_do_update_screenshot)
+
+## Automatic fix for compilation errors
+
+After applying tasks, app modernization for .NET will automatically find and fix compilation errors introduced by the code changes.
+
+
+# How do I get started?
+
+To use App Modernization for .NET, you need:
+- [A GitHub account with GitHub Copilot enabled](https://github.com/features/copilot)
+    - Pro, Pro+, Business or Enterprise plan is needed
+- [The GitHub Copilot extension](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot)
+    - The latest version is recommended
+- [AppCAT for .NET](../appcat/install.md)
+    - For the assessment feature of GitHub Copilot app modernization for .NET
+
+# Feedback
+
+We value your feedback — share [your thoughts here](https://aka.ms/AM4JFeedback) to help us continue improving the product.
+
+# License
+
+This extension is licensed under [GitHub Copilot Product Specifc Terms](https://github.com/customer-terms/github-copilot-product-specific-terms).
+
+# Trademarks
+
+This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow [Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general). Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.
+
+# Privacy statement
+
+App Modernization for .NET uses GitHub Copilot just like how you modify code with GitHub Copilot, which does not retain code snippets beyond the immediate session. Telemetry metrics are collected and analyzed to track feature usage and effectiveness. Please review the [Microsoft Privacy Statement](https://go.microsoft.com/fwlink/?LinkId=521839) if necessary.
+
+# Transparency note
+
+App Modernization for .NET uses GitHub Copilot to make code changes, and AI sometimes makes mistakes. Please carefully review and test the code changes made by the tool, before using them on your production environment.
+
+# More information
+
+Here is some documentation that may be helpful.
+* [Common modernization issues with predefined tasks](predefined-tasks.md)
+* [Quickstart on assessing an application and applying code changes](quick-start.md)
+* [Frequently Asked Questions](faq.md)

docs/azure/migration/appmod/predefined-tasks.md

@@ -0,0 +1,31 @@
+# Predefined tasks for GitHub Copilot App Modernization for .NET
+
+This article describes the predefined tasks available for GitHub Copilot App Modernization for .NET.
+
+Predefined tasks capture industry best practices for using Azure services. Currently, App Modernization for .NET offers predefined tasks that cover common migration scenarios. These tasks address the following subjects, and more:
+
+- Secret management
+- Message queue integration
+- Database migration
+- Identity management
+
+## Predefined Task list
+- Migrate to Managed Identity based Database migration to Azure, including Azure SQL DB and Azure PostgreSQL
+    - migrate from DB2, Oracle DB to Azure PostgreSQL
+    - migrate from local/on-prem SQL server to Azure SQL DB
+- Migrate to Azure Service Bus
+    - migrate from Microsoft Message Queue (MSMQ)
+    - migrate from RabbitMQ
+- Migrate to Confluent Cloud/Azure Event Hub for Apache Kafka
+    - migrate from local/on-prem Kafka
+- Migrate to secured crendentials with Managed Identity and Azure KeyVault
+    - migrate from plaintext credentials in configuration or code
+- Migrate to Azure Blob Storage
+    - migrate from on-prem or cross-cloud object storages
+    - migrate from file IO in local file system
+- Migrate to Azure File Storage
+    - migrate from file IO in local file system
+- Migrate to Microsoft Entra ID
+    - migrate from Windows AD
+- Migrate to Azure Communication Service email
+    - migrate from using SMTP protocol to send emails