Apply suggestions from code review

Co-authored-by: Jye Cusch <[email protected]>

Author: tjholm

docs/providers/pulumi/aws/index.mdx

@@ -55,23 +55,25 @@ You can create an Access Key by logging into the [AWS console](https://aws.amazo
   for full details on credentials and configuration.
 </Note>
 
-## Locating resources deployed with Nitric
+## Locating deployed resources
 
-Nitric creates a resource tag manager group and tags all possible resources to be referenced by this group. You can locate resources in the console by going to the [AWS Console](https://console.aws.amazon.com/)
+This Nitric AWS provider creates a resource tag manager group and tags all possible resources to be referenced by this group. You can locate resources using the [AWS Console](https://console.aws.amazon.com/).
 
-Navigate to the resource groups service:
+Start by navigating to the [Resource Groups service](https://console.aws.amazon.com/resource-groups/home):
 
 ![resource group search image](/docs/images/docs/aws-rg.png)
 
-Find your resource group in the resource groups list and click it:
+Find your stack's resource group in the list and click it:
 
-![resource group list image](/docs/images/docs/aws-rg-screen.png)
+<Note>
+  Resource groups are conventionally named `<project-name>-<stack-name>`
 
-Resource groups are conventionally named `<project-name>-<stack-name>`
+  In this example the project name is `api-testing` and the stack name is `aws`.
+</Note>
 
-So in the example above, the project name is `api-testing` and the stack name is `aws`.
+![resource group list image](/docs/images/docs/aws-rg-screen.png)
 
-More recent versions of the Nitric AWS provider also output a direct link to it's resource group in the console from running `nitric up`
+More recent versions of the Nitric AWS provider also display a direct link to the resource group in output from `nitric up`.
 
 Example:
 

docs/providers/pulumi/azure/index.mdx

@@ -75,20 +75,21 @@ brew update && brew install azure-cli
 
 </OSTabs>
 
-## Locating resources deployed with Nitric
+## Locating deployed resources
 
-Nitric deploys all Azure resources for a stack into a resource group dedicated to that stack. You can either use one your already have by configuring it in the stack configuration or let Nitric create one for you.
+This Nitric Azure provider deploys resources for a stack into a resource group dedicated to that stack. You can either use one your already have by configuring it in the stack configuration or let Nitric create one for you.
 
-Once a nitric stack is deployed to azure it's resource group should be present in the [Resource groups](https://portal.azure.com/#blade/HubsExtension/BrowseResourceGroupBlade/resourceType/Microsoft.Resources%2Fsubscriptions%2FresourceGroups) page of your portal. Assuming it was deployed to a subscription you have access to.
+Once a stack has been deployed to Azure it's resource group should be present in the [Resource groups](https://portal.azure.com/#blade/HubsExtension/BrowseResourceGroupBlade/resourceType/Microsoft.Resources%2Fsubscriptions%2FresourceGroups) page of the portal. Assuming it was deployed to a subscription you have access to.
 
-Resource groups are named conventionally `<project-name>-<stack-name>-<randomId>`
+<Note>
+  Resource groups are conventionally named `<project-name>-<stack-name>-<randomId>`
 
-For example:
-![resource group page screen](/docs/images/docs/az-rg.png)
+  In this example the project name is `api-testing` and the stack name is `az`.
+</Note>
 
-So in the example above, the project name is `api-testing` and the stack name is `az`.
+![resource group page screen](/docs/images/docs/az-rg.png)
 
-More recent versions of the Nitric Azure provider also output a direct link to it's resource group in the console from running `nitric up`
+More recent versions of the Nitric Azure provider display a direct link to the resource group in output from `nitric up`.
 
 Example:
 

docs/providers/terraform/aws.mdx

@@ -70,22 +70,23 @@ You can create an Access Key by logging into the [AWS console](https://aws.amazo
   for full details on credentials and configuration.
 </Note>
 
-## Locating resources deployed with Nitric
+## Locating deployed resources
 
 Nitric creates a resource tag manager group and tags all possible resources to be referenced by this group. You can locate resources in the console by going to the [AWS Console](https://console.aws.amazon.com/)
 
-Navigate to the resource groups service:
+Next, navigate to the [Resource Groups service](https://console.aws.amazon.com/resource-groups/home):
 
 ![resource group search image](/docs/images/docs/aws-rg.png)
 
-Find your resource group in the resource groups list and click it:
+Find your stack's resource group in the list and click it:
 
-![resource group list image](/docs/images/docs/aws-rg-screen.png)
-
-Resource groups are conventionally named `<project-name>-<stack-name>`
+<Note>
+  Resource groups are conventionally named `<project-name>-<stack-name>`
 
-So in the example above, the project name is `api-testing` and the stack name is `aws`.
+  In this example the project name is `api-testing` and the stack name is `aws`.
+</Note>
 
+![resource group list image](/docs/images/docs/aws-rg-screen.png)
 ## Stack Configuration
 
 ```yaml title:nitric.[stack ID].yaml