You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/azure/migration/appmod/quickstart.md
+14-14Lines changed: 14 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,7 +8,7 @@ author: alexwolfmsft
8
8
ms.author: alexwolf
9
9
---
10
10
11
-
# Quickstart: Assess and migrate a .NET project with GitHub Copilot app modernization for .NET (Preview)
11
+
# Quickstart: Assess and migrate a .NET project with GitHub Copilot app modernization for .NET
12
12
13
13
In this quickstart, you assess and migrate a .NET project by using GitHub Copilot app modernization for .NET. You complete the following tasks:
14
14
@@ -18,7 +18,7 @@ In this quickstart, you assess and migrate a .NET project by using GitHub Copilo
18
18
## Prerequisites
19
19
20
20
- Windows Operating System
21
-
-[Visual Studio 2022 version 17.14.16 or newer](https://visualstudio.microsoft.com/downloads/) (To be released)
21
+
-[Visual Studio 2022 version 17.14.16 or newer](https://visualstudio.microsoft.com/downloads/)
22
22
-[.NET desktop development workload](/visualstudio/install/modify-visual-studio?view=vs-2022&preserve-view=true#change-workloads-or-individual-components) with the following optional components enabled:
23
23
- GitHub Copilot
24
24
- GitHub Copilot app modernization for .NET
@@ -29,34 +29,34 @@ In this quickstart, you assess and migrate a .NET project by using GitHub Copilo
29
29
30
30
## Assess app readiness
31
31
32
-
App Modernization for .NET assessment helps you identify your application readiness challenges, understand their impact, and find recommended migration tasks. Each migration task includes references to set up Azure resources, add configurations, and make code changes. Follow these steps to start your migration process with assessment:
32
+
The app modernization for .NET assessment helps you find your app readiness challenges, understand their impact, and see recommended migration tasks. Each migration task includes references to set up Azure resources, add configurations, and make code changes. Follow these steps to start your migration process:
33
33
34
34
1. Clone the [.NET migration copilot samples](https://github.com/Azure-Samples/dotnet-migration-copilot-samples) repository to your local machine.
35
35
36
36
2. In Visual Studio, open the **Contoso University** solution from the samples repository.
37
37
38
-
3.Right-click the solution in Solution Explorer and select **Modernize**.
38
+
3.In the solution explorer, right-click the solution node and select **Modernize**.
39
39
40
40
:::image type="content" source="media/modernize-solution.png" alt-text="Screenshot that shows the modernize option in the context menu.":::
41
41
42
-
4.A GitHub Copilot Chat window opens with a welcome message and predefined options. Select **Migrate to Azure** from the available choices and send it to Copilot.
42
+
4.The GitHub Copilot Chat window opens with a welcome message and predefined options. Select **Migrate to Azure** from the available choices and send it to Copilot.
43
43
44
44
:::image type="content" source="media/modernization-welcome.png" alt-text="Screenshot that shows the welcome message with migration options.":::
45
45
46
46
> [!TIP]
47
-
> Alternative: Instead of steps 3 and 4, open **GitHub Copilot Chat** directly and send `@Modernize Migrate to Azure` to start the assessment and migration flow.
47
+
> Instead of steps 3 and 4, you can open **GitHub Copilot Chat** directly and send `@Modernize Migrate to Azure` to start the assessment and migration flow.
48
48
49
-
5. A new Copilot chat session opens and displays the welcome message. The assessment automatically begins and analyzes your project for migration readiness.
49
+
5. A new Copilot chat session opens and shows the welcome message. The assessment starts automatically and analyzes your project for migration readiness.
50
50
51
51
:::image type="content" source="media/assessment-in-process.png" alt-text="Screenshot that shows assessment in progress with status indicators.":::
52
52
53
-
6. When the assessment completes, you can view a comprehensive assessment report UI page and receive a list of migration tasks in the chat window.
53
+
6. When the assessment finishes, you see a comprehensive assessment report UI page and a list of migration tasks in the chat window.
54
54
55
55
:::image type="content" source="media/assessment-report.png" alt-text="Screenshot that shows the generated assessment report with detailed findings.":::
56
56
57
57
## App migrations
58
58
59
-
GitHub Copilot app modernization for .NET (Preview) includes [predefined tasks](predefined-tasks.md) for common migration scenarios, following Microsoft's best practices.
59
+
GitHub Copilot app modernization for .NET includes [predefined tasks](predefined-tasks.md) for common migration scenarios, following Microsoft's best practices.
60
60
61
61
### Start a migration task
62
62
@@ -68,21 +68,21 @@ Select the **Run Task** button in the Assessment Report generated in the previou
68
68
69
69
**Option 2. Send in Copilot Chat**
70
70
71
-
Send the migration task number (e.g., 1.1) or its name in the chat.
71
+
Send the migration task number (for example, 1.1) or its name in the chat.
72
72
73
73
:::image type="content" source="media/quickstart-chat-experience.png" alt-text="A screenshot showing sending the message in the Copilot Chat to start a migration task.":::
74
74
75
75
### Plan and progress tracker generation
76
76
77
-
- When you start the migration, GitHub Copilot begins a session named "App modernization: migrate from `<source technology>` to `<target technology>`" in agent mode with predefined prompts.
77
+
- When you start the migration, GitHub Copilot starts a session named "App modernization: migrate from `<source technology>` to `<target technology>`" in agent mode with predefined prompts.
78
78
- The tool creates two files in the `.appmod/.migration` folder:
79
79
-`plan.md` - the overall migration plan
80
80
-`progress.md` - a progress tracker; GitHub Copilot marks items as it completes tasks
81
-
- Edit these files to customize your migration before proceeding.
81
+
- Edit these files to customize your migration before you continue.
82
82
83
83
### Start code remediation
84
84
85
-
- If you're satisfied with the plan and progress tracker, enter a prompt to initiate the migration, such as the following:
85
+
- If you're satisfied with the plan and progress tracker, enter a prompt to start the migration, such as the following:
86
86
87
87
```console
88
88
`The plan and progress tracker look good to me. Go ahead with the migration.`
@@ -102,7 +102,7 @@ The GitHub Copilot app modernization for .NET extension provides default chat me
102
102
103
103
:::image type="content" source="media/quickstart-followup.png" alt-text="Screenshot that shows default chat message options in the Copilot Chat.":::
104
104
105
-
You can choose one of the predefined options below and send it in the chat:
105
+
You can choose one of the predefined options and send it in the chat:
106
106
107
107
- **Run modernization assessment**: Initiates a comprehensive new assessment of your application to identify migration readiness issues and Azure compatibility challenges.
108
108
- **View assessment report**: Opens the previously generated assessment report and provides a summarized list of migration tasks based on the assessment results. If no previous assessment exists, it automatically runs a new assessment first.
0 commit comments