restored intro, restored order for 'how it works' section

Author: rsill-neo4j

modules/ROOT/pages/index.adoc

@@ -5,43 +5,14 @@
 
 The Neo4j GraphQL Library is a highly flexible, low-code, open source JavaScript library that enables rapid API development for cross-platform and mobile applications by tapping into the power of connected data.
 
-== How it works
-
-Here is an example of how you can query existing data:
 
-[source, graphql, indent=0]
-----
-query {
-  products {
-    productName
-    category {
-      categoryName
-    }
-  }
-}
-----
+== How it works
 
-The response looks like this:
+The Neo4j GraphQL Library requires a set of type definitions that describes the shape of your graph data and creates an API layer to communicate with the data.
 
-[source, json, indent=0]
-----
-{
-  "data": {
-    "products": [
-      {
-        "productName": "New Product",
-        "category": [
-          {
-            "categoryName": "New Category"
-          }
-        ]
-      }
-    ]
-  }
-}
-----
+It generates an entire executable schema with all additional types needed to execute queries and mutations to interact with your Neo4j database.
 
-For the example query to work, the library requires the following type definitions:
+For example, consider these type definitions:
 
 [source, graphql, indent=0]
 ----
@@ -58,7 +29,7 @@ type Category @node {
 
 Based on these type definitions, the library generates query and mutation templates to create new instances of the types as well as query existing instances.
 
-The following mutation creates the new product and the new category which were queried above:
+The following mutation creates a new product as well as a new category:
 
 [source, graphql, indent=0]
 ----
@@ -81,6 +52,40 @@ mutation {
 }
 ----
 
+Here is an example of how you can query existing data:
+
+[source, graphql, indent=0]
+----
+query {
+  products {
+    productName
+    category {
+      categoryName
+    }
+  }
+}
+----
+
+The response looks like this:
+
+[source, json, indent=0]
+----
+{
+  "data": {
+    "products": [
+      {
+        "productName": "New Product",
+        "category": [
+          {
+            "categoryName": "New Category"
+          }
+        ]
+      }
+    ]
+  }
+}
+----
+
 For every query and mutation that is executed against this generated schema, the Neo4j GraphQL Library generates a single Cypher query which is executed against the database.
 This eliminates the https://www.google.com/search?q=graphql+n%2B1[N+1 Problem], which can make GraphQL implementations slow and inefficient.