Apply suggestions from code review

Co-authored-by: Richard Sill <[email protected]>

Author: Liam-Doodson

modules/ROOT/pages/aura-graphql-data-apis/index.adoc

@@ -1,8 +1,6 @@
 = GraphQL for Neo4j AuraDB Beta
 
-== Foreword
-
-Welcome to the beta release of *GraphQL for Neo4j AuraDB*.
+Welcome to the beta release of GraphQL for Neo4j AuraDB.
 
 We are thrilled to have you join us at this exciting stage of our journey. Participating is more than just trying out this feature – your feedback and insights will directly influence how we refine and evolve its future to meet the needs of users like you.
 
@@ -12,7 +10,7 @@ Here’s how you can help us get *GraphQL for Neo4j AuraDB* ready for production
 
 - *Dive in*: Explore and test its features to your heart’s content.
 - *Break stuff*: We’d rather discover weak areas at this stage – go for it, don’t hold back.
-- *Share your experience*: Tell us what works, what doesn’t, and what you’d like to see in the future.
+- *Share your experience*: Tell us what works, what doesn't, and what you'd like to see in the future.
 - *Stay in touch*: Use email (`[email protected]`), our `#graphql` channel on our https://discord.gg/M8mTADEJ[Discord Community], or our https://community.neo4j.com/c/drivers-stacks/graphql/33[forums] to report issues, suggest improvements, or ask questions.
 
 We value your time, creativity, and honest feedback – thank you for your trust and collaboration.

modules/ROOT/pages/aura-graphql-data-apis/prerequisites.adoc

@@ -4,66 +4,70 @@ Management of the beta of GraphQL for Neo4j AuraDB is performed using the Aura C
 
 == Read This Before You Start
 
-Using the GraphQL API during the Open Beta will be at no cost to you. Usage of the associated AuraDB instance will be charged as normal unless you’re using Aura Pro Trials which, as the name suggests, is a zero-cost option.
+Using the GraphQL API during the Open Beta is free of charge.
+Usage of the associated AuraDB instance will be charged as normal unless you're using Aura Pro Trials which is a zero-cost option.
 
-At the end of the beta period, all running GraphQL endpoints will be terminated and destroyed in preparation for the full release. Notification of this will be sent out two weeks before GraphQL endpoints are withdrawn.
+At the end of the beta period, all running GraphQL endpoints will be terminated in preparation for the full release.
+We will send out a notification two weeks before they are terminated.
 
 
-== Obtain Aura API Credentials
+== Obtain Aura API credentials
 
-The Aura CLI communicates with Neo4j AuraDB platform by use of an API. To use the API, a set of credentials is required. To get the credentials, follow these steps depending on which version of the console you are using.
+The Aura CLI communicates with Neo4j AuraDB platform via an API.
+To use the API, a set of credentials is required.
+To get the credentials, follow these steps depending on which version of the console you are using.
 
-=== New Unified Aura Console Experience
+=== New unified Aura Console experience
 
-1. Login into the https://console.neo4j.io/[Neo4j Aura Console]
-2. Navigate to the top right where your account name is displayed as shown in the red box below and click on the down arrow:
+1. Log in to the link:https://console.neo4j.io/[Neo4j Aura Console].
+2. Navigate to the top right where your account name is displayed  and click the down arrow.
 +
 image::aura-graphql-data-apis/unified-console-home.png[]
 +
-3. From the menu, choose API keys:
+3. In the menu, click *API keys*.
 +
 image::aura-graphql-data-apis/unified-console-account-dropdown.png[]
 +
-4. Select Create:
+4. Click *Create*.
 +
 image::aura-graphql-data-apis/unified-console-api-keys.png[]
 +
-5. On the pop-up window, enter a name for the API Key and then select Create:
+5. In the pop-up window, enter a name for the API Key and click *Create*.
 +
 image::aura-graphql-data-apis/unified-console-create-api-key.png[]
 +
-6. You will be shown the client id and client secret. Make a note as the client secret will not be shown again and you need both. If you download them, keep them safe
+6. The client ID and client secret are displayed. Make a note as the client secret will not be shown again and you need both. If you download them, keep them safe.
 
-=== Aura Console Classic
+=== Aura Console classic
 
-1. Login into the https://console.neo4j.io/[Neo4j Aura Console]
-2. Navigate to the top right where your account name is displayed as shown in the red box below and click on the down arrow:
+1. Log in to the link:https://console.neo4j.io/[Neo4j Aura Console].
+2. Navigate to the top right where your account name is displayed and click the down arrow.
 +
 image::aura-graphql-data-apis/console-classic-home.png[]
 +
-3. You will be shown a menu with your account name. Select Account Details
-4. From the Account Details display, select the Create button in the Aura API Credentials section:
+3. A menu with your account name is displayed. Click *Account Details*.
+4. In the *Account Details* menu, click *Create* in the *Aura API* credentials section.
 +
 image::aura-graphql-data-apis/console-classic-api-keys.png[]
 +
-5. On the pop-up window, enter a Client name, and select Create
-6. You will be shown the newly created Client ID and Client Secret. Make sure to securely save these as they are required to use the Aura CLI
+5. In the pop-up window, enter a client name and click *Create*.
+6. The newly created client ID and client secret are displayed. Make sure to securely save these as they are required to use the Aura CLI.
 
-== Install & Configure the Aura CLI
+== Install and configure the Aura CLI
 
 === Installation
 
-. Using your browser, navigate to https://github.com/neo4j/aura-cli/releases/tag/v1.1.0
+. Navigate to link:https://github.com/neo4j/aura-cli/releases/tag/v1.1.0[https://github.com/neo4j/aura-cli/releases/tag/v1.1.0] in your browser.
 +
 [NOTE]
 ====
-We advise using at least version 1.1.0 for managing your GraphQL APIs
+Use Aura CLI version 1.1.0 or higher for managing your GraphQL APIs.
 ====
 +
-. Download the compressed file that matches your computer. Make a note of the folder where the file is located
-. After the file has been downloaded, extract the contents
-. Open a command prompt and move to the location where you extracted the files
-. Complete the installation by moving the aura-cli executable file into the file path
+. Download the compressed file that matches your system. Make a note of the folder where the file is located.
+. After the file has been downloaded, extract the contents.
+. Open a command prompt and move to the location where you extracted the files.
+. Complete the installation by moving the aura-cli executable file into the file path.
 .. Mac/Linux users:
 +
 [source, bash, indent=0]
@@ -94,12 +98,17 @@ aura version v1.1.0
 
 [NOTE]
 ====
-If you are using a Mac, you may receive a rather alarming warning from Apple that aura-cli could not be verified. If this happens, then open *system settings*, select *Privacy & Security* on the left, and scroll down on the right. Select *Open Anyway*. This should not happen again. The aura-cli has been through the Apple certification process but this can take time to trickle down through the Apple ecosystem.
+If you are using a Mac, you may receive a warning from Apple that aura-cli could not be verified.
+If this happens, open *System Settings*, click *Privacy & Security* on the left, and scroll down on the right.
+Click *Open Anyway*.
+This should not happen again.
+The aura-cli has been through the Apple certification process but it can take time to trickle down through the Apple ecosystem.
 ====
 
-=== Add Aura API Credentials
+=== Add Aura API credentials
 
-Configure the Aura CLI with the Aura API client ID and client secret you obtained earlier. The Aura CLI refers to these as credentials and it is possible to have several sets of credentials and then choose which one to use.
+Configure the Aura CLI with the Aura API client ID and client secret you obtained earlier.
+The Aura CLI refers to these as credentials and it is possible to have several sets of credentials and then choose which one to use.
 
 . At the command prompt, enter the following, using your values for the items in CAPITALS:
 +
@@ -116,9 +125,10 @@ aura-cli instance list --output table
 ----
 
 
-=== Set the Beta Flag
+=== Set the beta flag
 
-Instruct the Aura CLI to make available the commands for the open beta. This requires setting a configuration option.
+Instruct the Aura CLI to make available the commands for the open beta.
+This requires setting a configuration option.
 
 . At the command prompt, enter the following:
 +
@@ -127,7 +137,7 @@ Instruct the Aura CLI to make available the commands for the open beta. This req
 aura-cli config set beta-enabled true
 ----
 +
-. Check commands are listed for the open beta:
+. Check if the commands are listed for the open beta:
 +
 [source, bash, indent=0]
 ----
@@ -165,25 +175,32 @@ Global Flags:
 Use "aura-cli data-api graphql [command] --help" for more information about a command.
 ----
 
-== Author GraphQL Type Definitions
+== Write GraphQL type definitions
 
-Before you create a GraphQL API for use with an Aura instance, you must have type definitions ready for use.
+Before you create a GraphQL API for use with an Aura instance, you must create type definitions.
 
-If you already have type definitions from an existing GraphQL implementation these can be used but some exceptions need to be dealt with as these are not currently supported.
+If you already have type definitions from an existing GraphQL implementation these can be used.
+However, you must deal with some exceptions.
+The following are not currently supported:
 
-* The `@customResolver`/`@populatedBy` directives
+* The `@customResolver` and `@populatedBy` directives
 * Subscriptions
 
-Using the https://graphql-toolbox.neo4j.io/[Neo4j GraphQL Toolbox] is an easy way to produce and try out type definitions. Use of the Toolbox requires a connection to your Aura instance.
+Using the link:https://graphql-toolbox.neo4j.io/[Neo4j GraphQL Toolbox] is an easy way to produce and try out type definitions.
+Use of the Toolbox requires a connection to your Aura instance.
 
 [NOTE]
 ====
-The *Neo4j GraphQL Toolbox* currently, supports version 6 of the `@neo4j/graphql` library. However, GraphQL APIs run the version 7 alpha. As a result, type definitions created via the toolbox may not be valid with a GraphQL API. You can find a list of the breaking changes https://github.com/neo4j/graphql/releases?q=%40neo4j%2Fgraphql%407.0.0-alpha&expanded=true[here].
+The *Neo4j GraphQL Toolbox* currently,supports version 6 of the `@neo4j/graphql` library.
+However, GraphQL APIs run the version 7 alpha.
+As a result, type definitions created via the toolbox may not be valid with a GraphQL API.
+You can find a list of the breaking changes link:https://github.com/neo4j/graphql/releases?q=%40neo4j%2Fgraphql%407.0.0-alpha&expanded=true[here].
 ====
 
-When your type definitions are ready, save them to a file. They will be used with the Aura CLI to create the GraphQL API.
+When your type definitions are ready, save them to a file.
+They will be used with the Aura CLI to create the GraphQL API.
 
-== Select the AuraDB Instance To Use
+== Select the AuraDB instance
 
 At the command prompt, type:
 
@@ -192,6 +209,8 @@ At the command prompt, type:
 aura-cli instance list
 ----
 
-Your AuraDB instances will be displayed along with their IDs. Make a note of the ID for the AuraDB instance that you will use with the GraphQL API.
+Your AuraDB instances are displayed along with their IDs.
+Make a note of the ID of the AuraDB instance that you will use with the GraphQL API.
 
-After choosing an AuraDB to use and obtaining it’s ID, you must also have its username and password to use for authentication. For AuraDB, the username will likely be neo4j and the password would have been shown when it was created. If you do not have this information you cannot proceed with this instance.
+After choosing an AuraDB to use and obtaining its ID, you must also have its username and password to use for authentication.
+For AuraDB, the username will likely be "neo4j" and the password has been shown when it was created.