AWS transform documentation change
Summary
Added documentation sections explaining how to use and customize AWS Transform-generated modernization plans for .NET repositories, including plan details, repository selection, and JSON customization options
Security assessment
The changes focus on workflow improvements and user guidance for transformation plan management without addressing security vulnerabilities or introducing security controls. No security-related terminology or mitigations are present.
Diff
diff --git a/transform/latest/userguide/dotnet-web-app.md b/transform/latest/userguide/dotnet-web-app.md index 8f409c524..65d2cc3c8 100644 --- a//transform/latest/userguide/dotnet-web-app.md +++ b//transform/latest/userguide/dotnet-web-app.md @@ -4,0 +5,2 @@ +Use the plan generated by AWS TransformCustomize the transformation plan + @@ -25,0 +28,61 @@ To modernize your .NET code using the AWS Transform web application, navigate to +## Use the plan generated by AWS Transform + +You can choose to use the AWS Transform plan created from discovering repositories with a higher probability of transformation success, which includes the last modified, root, and cross-dependent repositories. + +AWS Transform lists some high level details about the transformation plan, which include: + + * _Total number of repositories discovered_ This number of legacy .NET repositories that AWS Transform discovered using your source code repository connector. AWS Transform can scan a maximum of 1,000 repositories in each job. If you have more repositories to scan or transform, you can create multiple transformation jobs. + + * _Selected repositories_ The number of legacy .NET repositories that AWS Transform selected for transformation. + + * _Selected dependencies_ The number of dependencies that the selected repositories require, which AWS Transform auto-detected and added to the transformation plan. + + + + +The _Selected repositories_ table lists the selected repositories. You can search repositories by name, navigate to additional pages of repositories, and download a JSON formatted file that lists the selected repositories and their dependencies. You can make any changes in this view. + +The _Selected repositories_ table lists the following details about the repositories that AWS Transform selected for transformation: + + * Repository name + + * Source branch + + * Last modified date and time + + * Lines of code This allows you to see if you're approaching your quota limits. For more information, see [Quotas for AWS Transform](./transform-limits.html). + + * Dependent repositories You can click on the number of dependent repositories to view more details about these dependencies. + + + + +If you are happy with the AWS Transform generated transformation plan, select **Confirm repositories**. + +If you would like to make changes to the AWS Transform generated transformation plan, select Customize the transformation plan. + +## Customize the transformation plan + +If you choose not to Use the plan generated by AWS Transform, you can customize the list of repositories to transform using one of the following options: + + 1. Select repositories in the **Selected repositories** table. + + 1. When you add a repository to the plan, AWS Transform will select the repository's dependencies for you and automatically add them to the transformation plan. + + 2. You can also deselect repositories in the table. + + 2. Download the AWS Transform generated JSON list of repos and branches. + + 1. Selected _Download list_. + + 2. After you review and modify the JSON list, upload it here by selecting _Upload customized plan_. + + 3. If the JSON uploads successfully, the _Selected repositories_ table displays the selections you made. + + 3. You can select **Show dependent repos** to display the list of repositories that AWS Transform discovered are dependencies for the repositories you selected. + + 4. You can repeat these steps, if needed. When you are happy with your customized plan, select **Confirm repositories**. + + + +