Merge pull request #70 from aws-samples/tool-guides

Tool guides

Author: Thomas Moore

SampleApplications/2022/MediaCatalog/CloudFormation/mediacatalog.yml

@@ -0,0 +1,17 @@
+# Setting up your environment
+
+In order to follow this guide, you will need to have a development environment. The environment must have at a minimum:
+
+* A Microsoft Windows 10 or 11 laptop, desktop, EC2 Instance or Virtual Machine.
+* [Microsoft Visual Studio 2022 Community, or better.](https://visualstudio.microsoft.com/)
+* [Git source control.](https://git-scm.com/)
+* Administrative access to Windows.
+* [An AWS Account.](https://aws.amazon.com/free)
+* [IAM Credentials into your account.](https://us-east-1.console.aws.amazon.com/iamv2/home#/home)
+* [AWS Command Line Interface installed.](https://aws.amazon.com/cli/)
+
+This guide assumes that in addition to having Windows set up, you have already installed the tools listed above, and that you have configured access to your AWS Account for the command line. If you have not already done so, please complete the installation and configuration before proceeding. 
+
+
+[Next](./02-Sample-Application.md) <br/>
+[Back to Start](../README.md)

ToolGuides/toolkit-for-refactoring/01-Prerequisites/01-Setup.md

@@ -0,0 +1,34 @@
+# Sample Application
+
+Throughout this guide, we will be refactoring a sample application. This application is available in the AWS .NET Samples GitHub repository. 
+
+Download the code [here](https://github.com/aws-samples/aws-net-guides).
+
+At a command line, using your git client type:
+
+```
+git clone git@github.com:aws-samples/aws-net-guides.git
+```
+
+The sample application that we will use is in the sub folder: 
+
+```
+SampleApplications\2022\MediaCatalog\MediaLibrary4.8
+```
+
+The sample application has a required set of infrastructure that must be deployed into your account. The infrastructure is deployed using Cloud Formation. From the AWS Console, you can create a new CloudFormation stack and use the template located in the sample application.
+```
+aws-net-guides\SampleApplications\2022\MediaCatalog\CloudFormation\mediacatalog.yml
+```
+
+You can also deploy the stack from the AWS Command line using the following command in the aws-net-guides\SampleApplications\2022\MediaCatalog\CloudFormation\ folder.
+```
+aws cloudformation deploy --template-file MediaCatalog.yml --stack-name MediaCatalogStack --capabilities CAPABILITY_IAM
+```
+
+You should make a copy of the Sample Application code, as the actions in this guide will be destructive to the project and source code. For example copy the folder "SampleApplications\2022\MediaCatalog\MediaLibrary4.8" to "C:\Source\MediaLibrary4.8" as this will allow us to change the application source files, while still having the original source code available.
+
+The rest of this guide will assume that your sample project is stored in "C:\Source\MediaLibrary4.8\".
+
+[Next](./03-Sample-Tour.md) <br/>
+[Back to Start](../README.md)

ToolGuides/toolkit-for-refactoring/01-Prerequisites/02-Sample-Application.md

@@ -0,0 +1,47 @@
+# A Tour of the Sample Application
+
+In Visual Studio, open the solution file:
+```
+C:\Source\MediaLibrary4.8\MediaLibrary\MediaLibrary.sln
+```
+
+Once the solution file is open in Visual Studio, run the solution to have a look at the starting point for the sample application.
+
+![Media Catalog](img/home-page.png)
+
+From the main page, click the "Upload" link under the Upload title. 
+
+Use the Browse and Upload buttons to upload an image to the application.
+
+![Upload](img/upload.png)
+
+In the sample code folder, there are sample images provided by the Smithsonian Institution. These images can be found by going to the origional location that you cloned the repo and looking in the following folder structure.
+```
+aws-net-guides\SampleApplications\2022\MediaCatalog\MediaLibrary6.0\SampleImages\
+```
+
+Browse to this folder and select the image "NZP-20140817-6602RG-000003.jpg" click "Upload File" once the file has been selected.
+
+The upload process automatically uses Amazon Rekognition to scan the image for any content that might be offensive. The application code automatically rejects any image where any moderation flags have been found. 
+
+Once uploaded, the application will bring you to a list of the files that have been uploaded, and are ready to process. 
+
+![Process](img/process.png)
+
+Click the "Process" link beside the image. This will use Amazon Rekognition to scan the image and find labels for things that are in the image.
+
+The processing page will give you a list of all the labels that Rekognition has detected and give you an opportunity to save the labels that you want against the image.
+
+![Rekognition Results](img/results.png)
+
+Select the options for Cheetah, Wildlife, Animal and Mammal. Then click Save.
+
+You will then be brought back to the image list view. The image will no longer have a "Process" link, but will not have a link that allows you to view the previously saved results.
+
+![Final](img/final.png)
+
+This completes the tour of the Media Catalog application. Feel free to spend more time looking around the application and becoming familiar with the other functions that are available before moving on to the next part of the guide. 
+
+
+[Next](../02-Getting-Started/01-Instalation.md) <br/>
+[Back to Start](../README.md)

ToolGuides/toolkit-for-refactoring/01-Prerequisites/03-Sample-Tour.md

@@ -0,0 +1,29 @@
+# Installing the AWS Toolkit for .NET Modernization
+
+The AWS Toolkit for .NET Refactoring installs in Visual Studio as an extension. If you don't have Visual Studio open, start it now and select the option to continue without code.
+
+![Open VS](img/visual-studio-open.png)
+
+From Visual Studio, click on the Extensions menu item, and then click on Manage Extensions.
+
+![Manage Extensions](img/manage-extenstions.png)
+
+Make sure the option to search for “Online” extensions is selected. Then type “AWS” in the search field. Your extensions list will be filtered down. From this menu you can select the “AWS Toolkit for .NET Refactoring VS 2022” from the menu. Once selected, click the Download button.
+
+![Manage Extensions](img/download-toolkit.png)
+
+Once the download has been completed, you will receive a message that the changes will be scheduled once Visual Studio is closed. At this point, click the Close button, and shut down Visual Studio.
+
+![Close Visual Studio](img/close-visual-studio.png)
+
+Click the Close button, then close Visual Studio. Once Visual Studio closes, the Visual Studio Extension Installer application will run. 
+
+![Close Visual Studio](img/modify-visual-studio.png)
+
+Click the Modify button to allow Visual Studio to install the extension.
+
+This completes the installation of the .NET Refactoring Toolkit for .NET.
+
+
+[Next](./02-assessing-application.md) <br/>
+[Back to Start](../README.md)