Merge pull request #5 from b-juche/patch-2

edit ReadMe

Author: AdelGhabboun

README.md

@@ -10,29 +10,32 @@ description: "This project demonstrates how to use Powershell with NetApp Files
 
 # Azure NetAppFiles SDK NFSv3/NFS4.1 Sample Powershell
 
-This project demonstrates how to deploy NFSv3/NFSv4.1 protocol type volume using Powershell and Azure NetApp Files SDK.
+This project demonstrates how to deploy a volume with the NFSv3/NFSv4.1 protocol type by using Powershell and Azure NetApp Files SDK.
 
 In this sample application we perform the following operations:
 
 * Creation
   * ANF Account 
-  *	Capacity pool 
+  * Capacity pool 
   * NFS Volume 
 
-* Deletion, the clean up process takes place (not enabled by default, please set the parameter CleanupResources to $true if you want the clean up code to take a place),deleting all resources in the reverse order following the hierarchy otherwise we can't remove resources that have nested resources still live.
+* Deletion   
+	The clean-up process takes place, deleting all resources in the reverse order following the hierarchy. You cannot remove resources that have nested resources still live.   
+
+	Note that the clean-up operation is not enabled by default. You need to set the parameter CleanupResources to $true for the clean-up code to take effect. 
 
 
 If you don't already have a Microsoft Azure subscription, you can get a FREE trial account [here](http://go.microsoft.com/fwlink/?LinkId=330212).
 
 ## Prerequisites
 
 1. Azure Subscription
-1. Subscription needs to be enabled for Azure NetApp Files. For more information, please refer to [this](https://docs.microsoft.com/azure/azure-netapp-files/azure-netapp-files-register#waitlist) document.
-1. Resource Group created
-1. Virtual Network with a delegated subnet to Microsoft.Netapp/volumes resource. For more information, please refer to [Guidelines for Azure NetApp Files network planning](https://docs.microsoft.com/en-us/azure/azure-netapp-files/azure-netapp-files-network-topologies)
-1. Azure PowerShell, please refer to [Install Azure PowerShell](https://docs.microsoft.com/en-us/powershell/azure/install-az-ps?view=azps-4.8.0)
-1. Run the following PS command:
-	* Install-Module Az.NetAppFiles
+1. Subscription needs to be enabled for Azure NetApp Files. See [Submit a waitlist request for accessing the service](https://docs.microsoft.com/azure/azure-netapp-files/azure-netapp-files-register#waitlist).
+1. Resource Group must be created
+1. Virtual Network with a delegated subnet to Microsoft.Netapp/volumes resource. For more information, see [Guidelines for Azure NetApp Files network planning](https://docs.microsoft.com/en-us/azure/azure-netapp-files/azure-netapp-files-network-topologies).
+1. Azure PowerShell. See [Install Azure PowerShell](https://docs.microsoft.com/en-us/powershell/azure/install-az-ps?view=azps-4.8.0).
+1. Run the following PS command:   
+	`Install-Module Az.NetAppFiles`
 
 
 # How the project is structured
@@ -42,18 +45,18 @@ The following table describes all files within this solution:
 | Folder     | FileName                | Description                                                                                                                         |
 |------------|-------------------------|-------------------------------------------------------------------------------------------------------------------------------------|
 | src        | CreateANFVolume.ps      | Authenticates and executes all operations                                                                                           |
-| src\Common | CommonSDK.psm1          | PowerShell module that exposes some functions to perform creation and deletion Azure NetApp Files resource that calls the actual Az.NetAppFiles cmdlets							 |
-| src\Common | Utils.psm1              | Static class that exposes a few methods that helps on various tasks, like writting a log to the console for example.                |
-| src\Common | AzureAuth.psm1	       | PoweShell module that exposes functions to connect to Azure and choose target subscription                                          |
+| src\Common | CommonSDK.psm1          | PowerShell module that exposes some functions to perform creation and deletion of Azure NetApp Files resource that calls the actual Az.NetAppFiles cmdlets							 |
+| src\Common | Utils.psm1              | Static class that exposes a few methods that are helpful for various tasks, such as writing a log to the console for example.                |
+| src\Common | AzureAuth.psm1	       | PoweShell module that exposes functions to connect to Azure and choose the target subscription                                          |
 
 # How to run the PowerShell script
 
-1. Clone it locally
+1. Clone the repository locally
     ```powershell
     git clone https://github.com/Azure-Samples/netappfiles-powershell-nfs-sdk-sample.git
     ```
 	
-1. Modes: There are two options to run the script
+1. Use the basic mode or the advanced mode. There are two options to run the script:
 
 	Basic mode - Single script create Azure NetApp files with no validation.
 	 * Change folder to **netappfiles-powershell-nfs-sdk-sample\src\Basic**
@@ -102,15 +105,15 @@ The following table describes all files within this solution:
 
 # Troubleshoot
 
-If you encounter the below issue when running the PoweShell command 
+If you encounter the following issue when running the PoweShell command:  
 
 ```
 .\CreateANFVolume.ps1 : .\CreateANFVolume.ps1 cannot be loaded. The file .\CreateANFVolume.ps1 is not digitally signed. You cannot 
 run this script on the current system.
 ```
 
-Run the following command
-Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Bypass
+Run the following command:   
+`Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Bypass`
 
 # References