Updated the ordering and descriptions of pages

bbakerman · bbakerman · commit c66894001eee · 2018-10-17T12:14:31.000+11:00
diff --git a/content/documentation/master/batching.md b/content/documentation/master/batching.md
@@ -3,8 +3,8 @@ title: "Batching"
 date: 2018-09-09T12:52:46+10:00
 draft: false
 tags: [documentation]
-weight: 101
-description: Batching
+weight: 105
+description: How to avoid the dreaded N+1 calls for data and make your graphql system more efficient
 ---
 # Using Dataloader
 
diff --git a/content/documentation/master/concerns.md b/content/documentation/master/concerns.md
@@ -3,8 +3,8 @@ title: "Concerns"
 date: 2018-09-09T12:52:46+10:00
 draft: false
 tags: [documentation]
-weight: 102
-description: Application concerns
+weight: 111
+description:  Outlines certain application level concerns and how to address them
 ---
 # Application concerns
 
diff --git a/content/documentation/master/contributions.md b/content/documentation/master/contributions.md
@@ -3,8 +3,8 @@ title: "Contributions"
 date: 2018-09-09T12:52:46+10:00
 draft: false
 tags: [documentation]
-weight: 103
-description: Contributions
+weight: 1000
+description: Every contribution to make this project better is welcome. Thank you!
 ---
 # Contributions
 
diff --git a/content/documentation/master/data-fetching.md b/content/documentation/master/data-fetching.md
@@ -3,8 +3,8 @@ title: "Data fetching"
 date: 2018-09-09T12:52:46+10:00
 draft: false
 tags: [documentation]
-weight: 105
-description: Data fetching
+weight: 102
+description: How graphql-java fetches data for each of the fields in a query
 ---
 # Fetching data
 
diff --git a/content/documentation/master/data-mapping.md b/content/documentation/master/data-mapping.md
@@ -3,8 +3,8 @@ title: "Data mapping"
 date: 2018-09-09T12:52:46+10:00
 draft: false
 tags: [documentation]
-weight: 106
-description: Data mapping
+weight: 103
+description: How graphql-java maps object data to graphql types
 ---
 # Mapping data
 
diff --git a/content/documentation/master/defer.md b/content/documentation/master/defer.md
@@ -3,8 +3,8 @@ title: "Defer"
 date: 2018-09-09T12:52:46+10:00
 draft: false
 tags: [documentation]
-weight: 107
-description: Defer
+weight: 108
+description: Often when executing a query you have two classes of data.  The data you need immediately and the data that could arrive little bit later.
 ---
 # Deferred Execution
 
diff --git a/content/documentation/master/exceptions.md b/content/documentation/master/exceptions.md
@@ -4,7 +4,7 @@ date: 2018-09-09T12:52:46+10:00
 draft: false
 tags: [documentation]
 weight: 109
-description: Exceptions
+description: Outlines the exceptions used in graphql-java
 ---
 # Runtime Exceptions
 
diff --git a/content/documentation/master/execution.md b/content/documentation/master/execution.md
@@ -3,8 +3,8 @@ title: "Execution"
 date: 2018-09-09T12:52:46+10:00
 draft: false
 tags: [documentation]
-weight: 111
-description: Execution
+weight: 102
+description: How to execute a query using the graphql-java engine
 ---
 # Execution
 
diff --git a/content/documentation/master/fieldselection.md b/content/documentation/master/fieldselection.md
@@ -3,8 +3,8 @@ title: "Field selection"
 date: 2018-09-09T12:52:46+10:00
 draft: false
 tags: [documentation]
-weight: 112
-description: Field selection
+weight: 109
+description: How you can efficiently look ahead at the selected fields lower in the query
 ---
 # Field Selection
 
diff --git a/content/documentation/master/getting-started.md b/content/documentation/master/getting-started.md
@@ -39,7 +39,7 @@ Dependency:
     <dependency>
         <groupId>com.graphql-java</groupId>
         <artifactId>graphql-java</artifactId>
-        <version>9.0</version>
+        <version>10.0</version>
     </dependency>
 {{< / highlight >}}
 
diff --git a/content/documentation/master/instrumentation.md b/content/documentation/master/instrumentation.md
@@ -3,8 +3,9 @@ title: "Instrumentation"
 date: 2018-09-09T12:52:46+10:00
 draft: false
 tags: [documentation]
-weight: 115
-description: Instrumentation
+weight: 106
+description: Instrumentation allows you to inject code that can observe the execution of a query
+             and also change the runtime behaviours
 ---
 # Instrumentation
 
diff --git a/content/documentation/master/logging.md b/content/documentation/master/logging.md
@@ -3,8 +3,8 @@ title: "Logging"
 date: 2018-09-09T12:52:46+10:00
 draft: false
 tags: [documentation]
-weight: 115
-description: Logging
+weight: 110
+description: How logging is done in graphql-java
 ---
 # Logging
 
diff --git a/content/documentation/master/relay.md b/content/documentation/master/relay.md
@@ -3,8 +3,8 @@ title: "Relay"
 date: 2018-09-09T12:52:46+10:00
 draft: false
 tags: [documentation]
-weight: 115
-description: Relay
+weight: 109
+description: graphql-java has support for Relay
 ---
 # Relay Support
 
diff --git a/content/documentation/master/scalars.md b/content/documentation/master/scalars.md
@@ -3,8 +3,8 @@ title: "Scalars"
 date: 2018-09-09T12:52:46+10:00
 draft: false
 tags: [documentation]
-weight: 116
-description: Scalars
+weight: 104
+description: How scalar types work in graphql and how to write your own scalars
 ---
 # Scalars in graphql
 
diff --git a/content/documentation/master/schema.md b/content/documentation/master/schema.md
@@ -3,15 +3,17 @@ title: "Schema"
 date: 2018-09-09T12:52:46+10:00
 draft: false
 tags: [documentation]
-weight: 117
-description: Schema
+weight: 101
+description: Your GraphQL API has a schema which defines each field that can be queried or
+             mutated and what types those fields are.
+
 ---
 # Creating a schema
 
 
-A schema defines your GraphQL API by defining each field that can be queried or
-mutated.
-
+Your GraphQL API has a schema which defines each field that can be queried or
+             mutated and what types those fields are.
+             
 ``graphql-java`` offers two different ways of defining the schema: Programmatically as Java code or
 via a special graphql dsl (called SDL).
 
diff --git a/content/documentation/master/sdl-directives.md b/content/documentation/master/sdl-directives.md
@@ -4,7 +4,7 @@ date: 2018-09-09T12:52:46+10:00
 draft: false
 tags: [documentation]
 weight: 117
-description: SDL Directives
+description: How SDL Directives can be used to adjust the behavior of your graphql API
 ---
 # Schema Directives
 
diff --git a/content/documentation/master/subscriptions.md b/content/documentation/master/subscriptions.md
@@ -3,15 +3,17 @@ title: "Subscriptions"
 date: 2018-09-09T12:52:46+10:00
 draft: false
 tags: [documentation]
-weight: 120
-description: Subscriptions
+weight: 107
+description: Graphql subscriptions allow you subscribe to a reactive source and as new data arrives
+             a graphql query is applied over that data and the results are passed on.
+
 ---
 # Subscriptions
 
 ## Subscription Queries
 
 Graphql subscriptions allow you subscribe to a reactive source and as new data arrives
-then a graphql query is applied over that data and the results are passed on.
+a graphql query is applied over that data and the results are passed on.
 
 See http://graphql.org/blog/subscriptions-in-graphql-and-relay/ for more general details on
 graphql subscriptions.
diff --git a/content/documentation/v10/batching.md b/content/documentation/v10/batching.md
@@ -3,8 +3,8 @@ title: "Batching"
 date: 2018-09-09T12:52:46+10:00
 draft: false
 tags: [documentation]
-weight: 101
-description: Batching
+weight: 105
+description: How to avoid the dreaded N+1 calls for data and make your graphql system more efficient
 ---
 # Using Dataloader
 
diff --git a/content/documentation/v10/concerns.md b/content/documentation/v10/concerns.md
@@ -3,8 +3,8 @@ title: "Concerns"
 date: 2018-09-09T12:52:46+10:00
 draft: false
 tags: [documentation]
-weight: 102
-description: Application concerns
+weight: 111
+description:  Outlines certain application level concerns and how to address them
 ---
 # Application concerns
 
diff --git a/content/documentation/v10/contributions.md b/content/documentation/v10/contributions.md
@@ -3,8 +3,8 @@ title: "Contributions"
 date: 2018-09-09T12:52:46+10:00
 draft: false
 tags: [documentation]
-weight: 103
-description: Contributions
+weight: 1000
+description: Every contribution to make this project better is welcome. Thank you!
 ---
 # Contributions
 
diff --git a/content/documentation/v10/data-fetching.md b/content/documentation/v10/data-fetching.md
@@ -3,8 +3,8 @@ title: "Data fetching"
 date: 2018-09-09T12:52:46+10:00
 draft: false
 tags: [documentation]
-weight: 105
-description: Data fetching
+weight: 102
+description: How graphql-java fetches data for each of the fields in a query
 ---
 # Fetching data
 
diff --git a/content/documentation/v10/data-mapping.md b/content/documentation/v10/data-mapping.md
@@ -3,8 +3,8 @@ title: "Data mapping"
 date: 2018-09-09T12:52:46+10:00
 draft: false
 tags: [documentation]
-weight: 106
-description: Data mapping
+weight: 103
+description: How graphql-java maps object data to graphql types
 ---
 # Mapping data
 
diff --git a/content/documentation/v10/defer.md b/content/documentation/v10/defer.md
@@ -3,8 +3,8 @@ title: "Defer"
 date: 2018-09-09T12:52:46+10:00
 draft: false
 tags: [documentation]
-weight: 107
-description: Defer
+weight: 108
+description: Often when executing a query you have two classes of data.  The data you need immediately and the data that could arrive little bit later.
 ---
 # Deferred Execution
 
diff --git a/content/documentation/v10/exceptions.md b/content/documentation/v10/exceptions.md
@@ -4,7 +4,7 @@ date: 2018-09-09T12:52:46+10:00
 draft: false
 tags: [documentation]
 weight: 109
-description: Exceptions
+description: Outlines the exceptions used in graphql-java
 ---
 # Runtime Exceptions
 
diff --git a/content/documentation/v10/execution.md b/content/documentation/v10/execution.md
@@ -4,7 +4,7 @@ date: 2018-09-09T12:52:46+10:00
 draft: false
 tags: [documentation]
 weight: 111
-description: Execution
+description: How to execute a query using the graphql-java engine
 ---
 # Execution
 
diff --git a/content/documentation/v10/fieldselection.md b/content/documentation/v10/fieldselection.md
@@ -3,8 +3,8 @@ title: "Field selection"
 date: 2018-09-09T12:52:46+10:00
 draft: false
 tags: [documentation]
-weight: 112
-description: Field selection
+weight: 109
+description: How you can efficiently look ahead at the selected fields lower in the query
 ---
 # Field Selection
 
diff --git a/content/documentation/v10/instrumentation.md b/content/documentation/v10/instrumentation.md
@@ -3,8 +3,9 @@ title: "Instrumentation"
 date: 2018-09-09T12:52:46+10:00
 draft: false
 tags: [documentation]
-weight: 115
-description: Instrumentation
+weight: 106
+description: Instrumentation allows you to inject code that can observe the execution of a query
+             and also change the runtime behaviours
 ---
 # Instrumentation
 
diff --git a/content/documentation/v10/logging.md b/content/documentation/v10/logging.md
@@ -3,8 +3,8 @@ title: "Logging"
 date: 2018-09-09T12:52:46+10:00
 draft: false
 tags: [documentation]
-weight: 115
-description: Logging
+weight: 110
+description: How logging is done in graphql-java
 ---
 # Logging
 
diff --git a/content/documentation/v10/relay.md b/content/documentation/v10/relay.md
@@ -3,8 +3,8 @@ title: "Relay"
 date: 2018-09-09T12:52:46+10:00
 draft: false
 tags: [documentation]
-weight: 115
-description: Relay
+weight: 109
+description: graphql-java has support for Relay
 ---
 # Relay Support
 
diff --git a/content/documentation/v10/scalars.md b/content/documentation/v10/scalars.md
@@ -3,8 +3,8 @@ title: "Scalars"
 date: 2018-09-09T12:52:46+10:00
 draft: false
 tags: [documentation]
-weight: 116
-description: Scalars
+weight: 104
+description: How scalar types work in graphql and how to write your own scalars
 ---
 # Scalars in graphql
 
diff --git a/content/documentation/v10/schema.md b/content/documentation/v10/schema.md
@@ -3,8 +3,9 @@ title: "Schema"
 date: 2018-09-09T12:52:46+10:00
 draft: false
 tags: [documentation]
-weight: 117
-description: Schema
+weight: 101
+description: Your GraphQL API has a schema which defines each field that can be queried or
+             mutated and what types those fields are.
 ---
 # Creating a schema
 
diff --git a/content/documentation/v10/sdl-directives.md b/content/documentation/v10/sdl-directives.md
@@ -4,7 +4,7 @@ date: 2018-09-09T12:52:46+10:00
 draft: false
 tags: [documentation]
 weight: 117
-description: SDL Directives
+description: How SDL Directives can be used to adjust the behavior of your graphql API
 ---
 # Schema Directives
 
diff --git a/content/documentation/v10/subscriptions.md b/content/documentation/v10/subscriptions.md
@@ -3,8 +3,9 @@ title: "Subscriptions"
 date: 2018-09-09T12:52:46+10:00
 draft: false
 tags: [documentation]
-weight: 120
-description: Subscriptions
+weight: 107
+description: Graphql subscriptions allow you subscribe to a reactive source and as new data arrives
+             a graphql query is applied over that data and the results are passed on.
 ---
 # Subscriptions
 
diff --git a/content/documentation/v9/batching.md b/content/documentation/v9/batching.md
@@ -3,8 +3,8 @@ title: "Batching"
 date: 2018-09-09T12:52:46+10:00
 draft: false
 tags: [documentation]
-weight: 101
-description: Batching
+weight: 105
+description: How to avoid the dreaded N+1 calls for data and make your graphql system more efficient
 ---
 # Using Dataloader
 
diff --git a/content/documentation/v9/concerns.md b/content/documentation/v9/concerns.md
@@ -3,8 +3,8 @@ title: "Concerns"
 date: 2018-09-09T12:52:46+10:00
 draft: false
 tags: [documentation]
-weight: 102
-description: Application concerns
+weight: 111
+description:  Outlines certain application level concerns and how to address them
 ---
 # Application concerns
 
diff --git a/content/documentation/v9/contributions.md b/content/documentation/v9/contributions.md
diff --git a/content/documentation/v9/data-fetching.md b/content/documentation/v9/data-fetching.md
diff --git a/content/documentation/v9/data-mapping.md b/content/documentation/v9/data-mapping.md
diff --git a/content/documentation/v9/defer.md b/content/documentation/v9/defer.md
diff --git a/content/documentation/v9/exceptions.md b/content/documentation/v9/exceptions.md
diff --git a/content/documentation/v9/execution.md b/content/documentation/v9/execution.md
diff --git a/content/documentation/v9/fieldselection.md b/content/documentation/v9/fieldselection.md
diff --git a/content/documentation/v9/instrumentation.md b/content/documentation/v9/instrumentation.md
diff --git a/content/documentation/v9/logging.md b/content/documentation/v9/logging.md
diff --git a/content/documentation/v9/relay.md b/content/documentation/v9/relay.md
diff --git a/content/documentation/v9/scalars.md b/content/documentation/v9/scalars.md
diff --git a/content/documentation/v9/schema.md b/content/documentation/v9/schema.md
diff --git a/content/documentation/v9/sdl-directives.md b/content/documentation/v9/sdl-directives.md
diff --git a/content/documentation/v9/subscriptions.md b/content/documentation/v9/subscriptions.md
