edits

Author: ktoliver

articles/mysql/flexible-server/quickstart-create-arm-template.md

@@ -1,6 +1,6 @@
 ---
-title: 'Quickstart: Create using ARM template'
-description: In this Quickstart, learn how to create an Azure Database for MySQL - Flexible Server instance by using an ARM template.
+title: 'Quickstart: Create a flexible server by using Azure Resource Manager'
+description: In this quickstart, learn how to deploy a database in an instance of Azure Database for MySQL - Flexible Server by using an Azure Resource Manager template.
 ms.service: mysql
 ms.subservice: flexible-server
 ms.topic: quickstart
@@ -10,7 +10,7 @@ ms.custom: subject-armqs, mode-arm, devx-track-arm-template
 ms.date: 02/16/2023
 ---
 
-# Quickstart: Use an ARM template to create an Azure Database for MySQL - Flexible Server instance
+# Quickstart: Create an instance of Azure Database for MySQL - Flexible Server by using Azure Resource Manager
 
 [!INCLUDE[applies-to-mysql-flexible-server](../includes/applies-to-mysql-flexible-server.md)]
 
@@ -24,7 +24,7 @@ ms.date: 02/16/2023
 
 [!INCLUDE [flexible-server-free-trial-note](../includes/flexible-server-free-trial-note.md)]
 
-## Create server with public access
+## Create a server that has public access
 
 Create an **azuredeploy.json** file with the following content to create an Azure Database for MySQL flexible server instance using public access connectivity method and also create a database on the server. Update the **firewallRules** default value if needed.
 
@@ -254,9 +254,9 @@ Create an **azuredeploy.json** file with the following content to create an Azur
 }
 ```
 
-## Create a server with private access
+## Create a server that has private access
 
-Create an **azuredeploy.json** file with the following content to create an Azure Database for MySQL flexible server instance using private access connectivity method inside a virtual network.
+Modify the following code samples to create an Azure Database for MySQL flexible server that has private access connectivity inside a virtual network:
 
 ```json
 {

articles/mysql/flexible-server/quickstart-create-bicep.md

@@ -1,6 +1,6 @@
 ---
-title: 'Quickstart: Create using Bicep'
-description: In this Quickstart, learn how to create an Azure Database for MySQL - Flexible Server instance by using Bicep.
+title: 'Quickstart: Create a flexible server by using Bicep'
+description: In this quickstart, learn how to deploy a database in an instance of Azure Database for MySQL - Flexible Server by using Bicep.
 ms.service: mysql
 ms.subservice: flexible-server
 ms.custom: devx-track-bicep
@@ -10,7 +10,7 @@ ms.author: shaithal
 ms.date: 02/16/2023
 ---
 
-# Quickstart: Use a Bicep file to create an Azure Database for MySQL - Flexible Server instance
+# Quickstart: Create an instance of Azure Database for MySQL - Flexible Server by using a Bicep file
 
 [!INCLUDE[applies-to-mysql-flexible-server](../includes/applies-to-mysql-flexible-server.md)]
 
@@ -26,9 +26,9 @@ ms.date: 02/16/2023
 
 ## Create server with public access
 
-Create a **main.bicep** file and a **CreateFirewallRules.bicep** file with the following content to create an Azure Database for MySQL flexible server instance using public access connectivity method and also create a database on the server. Update the **firewallRules** default value if needed.
+Modify the following code samples to create a *main.bicep* file and a *CreateFirewallRules.bicep* file. Use the files to create an Azure Database for MySQL flexible server that has public access and to create a database on the server. You might need to modify the `firewallRules` default value.
 
-**main.bicep**
+*main.bicep*:
 
 ```bicep
 @description('Provide a prefix for creating resource names.')
@@ -37,14 +37,14 @@ param resourceNamePrefix string
 @description('Provide the location for all the resources.')
 param location string = resourceGroup().location
 
-@description('Provide the administrator login name for the MySQL server.')
+@description('Provide the administrator login username for the flexible server.')
 param administratorLogin string
 
-@description('Provide the administrator login password for the MySQL server.')
+@description('Provide the administrator login password for the flexible server.')
 @secure()
 param administratorLoginPassword string
 
-@description('Provide an array of firewall rules to be applied to the MySQL server.')
+@description('Provide an array of firewall rules to apply to the flexible server.')
 param firewallRules array = [
   {
     name: 'rule1'
@@ -58,7 +58,7 @@ param firewallRules array = [
   }
 ]
 
-@description('The tier of the particular SKU. High Availability is available only for GeneralPurpose and MemoryOptimized sku.')
+@description('The tier of the particular SKU. High availability mode is available only in the GeneralPurpose and MemoryOptimized SKUs.')
 @allowed([
   'Burstable'
   'GeneralPurpose'
@@ -73,18 +73,18 @@ param serverEdition string = 'Burstable'
 ])
 param version string = '8.0.21'
 
-@description('Availability Zone information of the server. (Leave blank for No Preference).')
+@description('The availability zone information for the server. (For no preference, leave blank.)')
 param availabilityZone string = '1'
 
-@description('High availability mode for a server : Disabled, SameZone, or ZoneRedundant')
+@description('High availability mode for a server: Disabled, SameZone, or ZoneRedundant.')
 @allowed([
   'Disabled'
   'SameZone'
   'ZoneRedundant'
 ])
 param haEnabled string = 'Disabled'
 
-@description('Availability zone of the standby server.')
+@description('The availability zone of the standby server.')
 param standbyAvailabilityZone string = '2'
 
 param storageSizeGB int = 20
@@ -95,7 +95,7 @@ param storageIops int = 360
 ])
 param storageAutogrow string = 'Enabled'
 
-@description('The name of the sku, e.g. Standard_D32ds_v4.')
+@description('The name of the SKU, such as Standard_D32ds_v4.')
 param skuName string = 'Standard_B1ms'
 
 param backupRetentionDays int = 7
@@ -158,7 +158,7 @@ resource database 'Microsoft.DBforMySQL/flexibleServers/databases@2021-12-01-pre
 }
 ```
 
-**CreateFirewallRules.bicep**
+*CreateFirewallRules.bicep*:
 
 ```bicep
 param serverName string
@@ -173,11 +173,11 @@ resource firewallRules 'Microsoft.DBforMySQL/flexibleServers/firewallRules@2021-
 }
 ```
 
-Save the two Bicep files in the same directly.
+Save the two Bicep files in the same directory.
 
-## Create a server with private access
+## Create a server that has private access
 
-Create an **main.bicep** file with the following content to create an Azure Database for MySQL flexible server instance using private access connectivity method inside a virtual network.
+Modify the following code samples to deploy an Azure Database for MySQL flexible server that has private access inside a virtual network:
 
 ```bicep
 @description('Provide a prefix for creating resource names.')
@@ -199,7 +199,7 @@ param vnetAddressPrefix string = '10.0.0.0/16'
 @description('Provide Subnet Address Prefix')
 param subnetPrefix string = '10.0.0.0/24'
 
-@description('Provide the tier of the particular SKU. High Availability is available only for GeneralPurpose and MemoryOptimized sku.')
+@description('Provide the tier of the specific SKU. High availability is available only in the GeneralPurpose and MemoryOptimized SKUs.')
 @allowed([
   'Burstable'
   'Generalpurpose'
@@ -214,7 +214,7 @@ param serverEdition string = 'Burstable'
 ])
 param serverVersion string = '8.0.21'
 
-@description('Provide the availability zone information of the server. (Leave blank for No Preference).')
+@description('The availability zone information for the server. (If you don't have a preference, leave blank.)')
 param availabilityZone string = '1'
 
 @description('Provide the high availability mode for a server : Disabled, SameZone, or ZoneRedundant')
@@ -323,7 +323,7 @@ resource database 'Microsoft.DBforMySQL/flexibleServers/databases@2021-12-01-pre
 
 ## Deploy the template
 
-Deploy the Bicep file using either Azure CLI or Azure PowerShell.
+Deploy the Bicep file by using either the Azure CLI or Azure PowerShell.
 
 # [CLI](#tab/CLI)
 
@@ -359,6 +359,7 @@ az resource list --resource-group exampleRG
 ```azurepowershell
 Get-AzResource -ResourceGroupName exampleRG
 ```
+
 ---
 
 ## Clean up resources
@@ -379,14 +380,7 @@ Remove-AzResourceGroup -Name exampleRG
 
 ---
 
-## Next steps
-
-For a step-by-step tutorial that guides you through the process of creating a Bicep template, see:
-
-> [!div class="nextstepaction"]
-> [Quickstart: Create Bicep files with Visual Studio Code](../../azure-resource-manager/bicep/quickstart-create-bicep-use-visual-studio-code.md)
-
-For a step-by-step tutorial to build an app with App Service using MySQL, see:
+## Related content
 
-> [!div class="nextstepaction"]
-> [Build a PHP (Laravel) web app with MySQL](tutorial-php-database-app.md)
+- For a step-by-step tutorial that guides you through the process of creating a Bicep template, see [Quickstart: Create Bicep files with Visual Studio Code](../../azure-resource-manager/bicep/quickstart-create-bicep-use-visual-studio-code.md).
+- For a step-by-step tutorial that shows how to build an app by using Azure App Service and MySQL, see[Build a PHP (Laravel) web app with MySQL](tutorial-php-database-app.md).