Apply suggestions from code review

deploy and operate section

Author: rsill-neo4j

modules/ROOT/pages/aura-graphql-data-apis/deploy-and-operate.adoc

@@ -1,14 +1,16 @@
-= Deploy and Operate
+= Deploy and operate
 
 == Deploy a GraphQL API
 
 
-Deploying a GraphQL API requires you first to have completed the steps in xref::/aura-graphql-data-apis/prerequisites.adoc[Prerequisites]. Of particular importance is that you have:
+Before you deploy a GraphQL API, complete the steps in xref::/aura-graphql-data-apis/prerequisites.adoc[Prerequisites].
+Make sure that you have:
 
-* The ID, username and password for the AuraDB
-* A file containing the type definitions
+* The ID, username and password for the AuraDB.
+* A file containing the type definitions.
 
-You are now ready to create the GraphQL API with the Aura CLI. Substitute the values in `CAPITALS` to match your setup:
+You are now ready to create the GraphQL API with the Aura CLI.
+Substitute the values in `CAPITALS` to match your setup:
 
 [source, bash, indent=0]
 ----
@@ -18,7 +20,8 @@ FULL_PATH_TO_YOUR_TYPE_DEFS --await
 
 [NOTE]
 ====
-Make sure to record the API key shown in the response as it will not be displayed again. If the API key is lost, a new one can be created by following the steps to create a new API key auth provider in the xref::/aura-graphql-data-apis/authentication-providers.adoc[authentication provider] section
+Make sure to record the API key shown in the response as it will not be displayed again.
+If the API key is lost, a new one can be created by following the steps to create a new API key auth provider in xref::/aura-graphql-data-apis/authentication-providers.adoc[Authentication providers].
 ====
 
 There are other items of note in the response:
@@ -36,29 +39,34 @@ aura-cli data-api graphql list --instance-id YOUR_AURA_INSTANCE_ID
 
 When the status changes to `ready`, the GraphQL API is available for servicing requests.
 
-== Modifying an Existing GraphQL API
+== Modifying an existing GraphQL API
 
-It is possible to change the configuration of an existing GraphQL API. The following properties can be modified:
+It is possible to change the configuration of an existing GraphQL API.
+The following properties can be modified:
 
 * Friendly name of the GraphQL API
 * Username and/or password for the associated Aura instance
 * Type definitions
 
-To do this, use the Aura CLI update command which requires IDs of the GraphQL API and it’s linked AuraDB instance. The format of this Aura CLI command is as follows:
+To do this, use the Aura CLI update command which requires IDs of the GraphQL API and its linked AuraDB instance.
+The format of this Aura CLI command is as follows:
 
 [source, bash, indent=0]
 ----
 aura-cli data-api graphql update YOUR_GRAPHQL_API_ID --instance-id YOUR_AURA_INSTANCE_ID <flags>
 ----
 
-As the change takes a few moments to fully implement, you should check the status of the GraphQL API after performing this operation; if the status is `updating` then the change is still being processed. When the change is committed, the status will return to `ready`.
+As the change takes a few moments to apply, check the status of the GraphQL API after performing this operation.
+If the status is `updating` then the change is still being processed.
+When the change is committed, the status will return to `ready`.
 
-
-Additionally, it is possible to modify the authentication providers of GraphQL APIs. More on what these are and how to do this xref::/aura-graphql-data-apis/authentication-providers.adoc[here].
+Additionally, it is possible to modify the authentication providers of GraphQL APIs.
+To learn more, see xref::/aura-graphql-data-apis/authentication-providers.adoc[Authentication providers].
 
 == Deleting a GraphQL API
 
-When you no longer require the GraphQL API then delete it by using the Aura CLI delete command. This will require the Aura instance ID and ID of the GraphQL API.
+When you no longer require the GraphQL API then delete it by using the Aura CLI delete command.
+This requires the Aura instance ID and the ID of the GraphQL API.
 
 The format of this command is as follows:
 
@@ -67,7 +75,7 @@ The format of this command is as follows:
 aura-cli data-api graphql delete YOUR_GRAPHQL_API_ID --instance-id YOUR_AURA_INSTANCE_ID
 ----
 
-[NOTE]
+[CAUTION]
 ====
-There is no additional confirmation - the GraphQL API will start to be deleted as soon as you press the Enter key!
+There is no additional confirmation - the GraphQL API will start to be deleted as soon as you execute the command.
 ====