added some more outlines

docs/_config.yml

@@ -19,7 +19,6 @@ sidebar_categories:
     - schemas/types
     - schemas/resolvers
     - schemas/context
-    - schemas/connecting-data
     - schemas/organizing-code
   Running a Server:
     - server/index
@@ -37,6 +36,7 @@ sidebar_categories:
     - best-practices/monitoring
     - best-practices/versioning
     - best-practices/schema-stitching
+    - best-practices/deploying
   Working with Backends:
     - backends/general
     - backends/sql

docs/source/best-practices/deploying.md

@@ -0,0 +1,14 @@
+---
+title: Deploying your app
+description: Deploying your new Apollo Server into the world
+---
+
+Deploying your Apollo Server is super easy with a lot of modern tools. Though you may need to customize it to your infrastructure, there are some tools to make it reliable and secure.
+
+<h2 id="aws">AWS</h2>
+
+<h2 id="heroku">Heroku</h2>
+
+<h2 id="now">Now</h2>
+
+<h2 id="serverless">Serverless</h2>

docs/source/best-practices/schema-design.md

@@ -2,3 +2,8 @@
 title: Schema Design
 description: The best way to fetch data, update it, and keep things running for a long time
 ---
+
+<h2 id="mutations">Mutation design</h2>
+<h2 id="unique-ids">Uniqe ids</h2>
+<h2 id="node">The node interface</h2>
+<h2 id="pagination">Pagination</h2>

docs/source/essentials/basics.md

@@ -2,3 +2,11 @@
 title: What is GraphQL?
 description: A quick guide to the basics of GraphQL and Apollo?
 ---
+
+GraphQL is a query language for APIs and a runtime for fulfilling those queries with your existing data, but what does that mean? What are opeations, schemas, and why do you need a server? With this guide we break down the building blocks of GraphQL and what they mean for your app.
+
+<h2 id="graphql-basics">GraphQL basics</h2>
+
+<h2 id="what-server-does">What a GraphQL server does</h2>
+
+<h2 id="graphql-libraries">The Apollo Server ecosystem</h2>

docs/source/essentials/building-schema.md

@@ -1,4 +1,12 @@
 ---
-title: Building a Schema
+title: Building a schema
 description: The why, what, and how of building a schema
 ---
+
+The schema is the core of your GraphQL service. It validates operations, routes queries to data, powers next generation develoment tools, and is the contract between clients and your service. With Apollo Server, building a schema is as easy ad describing your schema and joining it with some simple functions to return the data.
+
+<h2 id="type-definitions">Type Definitions</h2>
+
+<h2 id="resolvers">Resolvers</h2>
+
+<h2 id="viewing">Viewing your schema</h2>

docs/source/essentials/getting-started.md

@@ -1,4 +1,12 @@
 ---
-title: Getting Started
+title: Getting started
 description: Add Apollo to your app in a few lines of code
 ---
+
+Apollo Server provides two easy ways to get up and running quickly. For GraphQL first apps, the batteries included server setup `ApolloServer` is the best way to get started. If you have a node app already, Apollo Server provides easy to use middleware to plug into your current app right away.
+
+<h2 id="creating-server">Creating the server</h2>
+
+<h2 id="adding-graphql">Adding GraphQL</h2>
+
+<h2 id="making-sure-it-works">Running your first query</h2>

docs/source/essentials/loading-data.md

@@ -1,4 +1,12 @@
 ---
-title: Loading Your Data
+title: Loading your data
 description: Turning queries into data
 ---
+
+Once you have a working schema, you need to load some actual data for your app! Using resolvers you can fetch data from your backend, select and rename the results from your data sources, and link different information together. Learn how flexible GraphQL is in how it can translate requests into data with resolvers.
+
+<h2 id="fetching">Fetching data</h2>
+
+<h2 id="shaping">Shaping results</h2>
+
+<h2 id="linking">Linking data sources</h2>

docs/source/schemas/connecting-data.md

@@ -1,4 +0,0 @@
----
-title: Connecting Data
-description: When to connect, read, and write to your data sources
----

docs/source/schemas/context.md

@@ -2,3 +2,9 @@
 title: Using Context
 description: How to use context to make your app faster, easier to test, and contained
 ---
+
+<h2 id="creating-context">Creating a context</h2>
+
+<h2 id="using-context">Using the context</h2>
+
+<h2 id="context-best-practices">Getting the most out of your context</h2>

docs/source/schemas/organizing-code.md

@@ -2,3 +2,9 @@
 title: Organizing Code
 description: Scaling your Apollo Server from a single file to your entire team
 ---
+
+<h2 id="application-structure">Structuring your application</h2>
+
+<h2 id="splitting-types">Isolating types</h2>
+
+<h2 id="loading-typedefs">Loading type definitions</h2>

docs/source/schemas/resolvers.md

@@ -2,3 +2,9 @@
 title: Resolvers
 description: How to fetch data, select fom the results, and join types together
 ---
+
+<h2 id="args">Arguments</h2>
+
+<h2 id="merging">Merging resolvers</h2>
+
+<h2 id="abstractions">Resolver abstractions</h2>

docs/source/schemas/types.md

@@ -2,3 +2,11 @@
 title: Schema Types
 description: How to write your types, expose your data, and keep it all working great
 ---
+
+<h2 id="root-types">Query, Mutation, and Subscription</h2>
+
+<h2 id="object-types">Object types</h2>
+
+<h2 id="interfaces">Interfaces</h2>
+
+<h2 id="enums-and-scalars">Enums and scalars</h2>

docs/source/server/index.md

@@ -1,4 +1,12 @@
 ---
 title: ApolloServer
-description: All of the thing you need with no config needed!
+description: All of the things you need with no config needed!
 ---
+
+If you are starting out with a brand new application, the `ApolloServer` class is the best way to get up and running quickly with the ideal server setup.
+
+<h2 id="creating-a-server">Creating a server</h2>
+
+<h2 id="customizing">Customizing Apollo</h2>
+
+<h2 id="using-with-engine">Using with Apollo Engine</h2>