lots of small docs tweaks

Author: lacker

site/docs/APIReference-Utilities.md

@@ -3,7 +3,7 @@ title: graphql/utilities
 layout: ../_core/CodeLayout
 category: API Reference
 permalink: /docs/api-reference-utilities/
-sublinks: introspectionQuery,buildClientSchema,printSchema,printIntrospectionSchema,buildASTSchema,typeFromAST,astFromValue,TypeInfo,isValidJSValue,isValidLiteralValue
+sublinks: introspectionQuery,buildClientSchema,printSchema,printIntrospectionSchema,buildASTSchema,typeFromAST,astFromValue,TypeInfo,isValidJSValue,isValidLiteralValue,buildSchema
 next: /docs/api-reference-validation/
 ---
 
@@ -37,6 +37,12 @@ var GraphQLUtilities = require('graphql/utilities'); // CommonJS
 *Schema Language*
 
 <ul class="apiIndex">
+  <li>
+    <a href="#buildschema">
+      <pre>function buildSchema</pre>
+      Builds a Schema object from GraphQL schema language.
+    </a>
+  </li>
   <li>
     <a href="#printschema">
       <pre>function printSchema</pre>
@@ -126,6 +132,14 @@ server-internal mechanisms.
 
 ## Schema Representation
 
+### buildSchema
+
+```js
+function buildSchema(source: string | Source): GraphQLSchema {
+```
+
+Creates a GraphQLSchema object from GraphQL schema language. For more detail on the GraphQL schema language, see the [schema language docs](/learn/schema/) or this [schema language cheat sheet](https://wehavefaces.net/graphql-shorthand-notation-cheatsheet-17cd715861b6#.9oztv0a7n).
+
 ### printSchema
 
 ```js

site/docs/Guides-ConstructingTypes.md

@@ -41,7 +41,7 @@ var fakeDatabase = {
 };
 
 var root = {
-  user: function({id}) {
+  user: function ({id}) {
     return fakeDatabase[id];
   }
 };

site/docs/Tutorial-Authentication.md

@@ -30,7 +30,7 @@ function loggingMiddleware(req, res, next) {
 }
 
 var root = {
-  ip: function(args, request) {
+  ip: function (args, request) {
     return request.ip;
   }
 };

site/docs/Tutorial-GraphQLClients.md

@@ -31,7 +31,7 @@ xhr.responseType = 'json';
 xhr.open("POST", "/graphql");
 xhr.setRequestHeader("Content-Type", "application/json");
 xhr.setRequestHeader("Accept", "application/json");
-xhr.onload = function() {
+xhr.onload = function () {
   console.log('data returned:', xhr.response);
 }
 xhr.send(JSON.stringify({query:"{ hello }"}));

site/docs/Tutorial-Mutations.md

@@ -25,10 +25,10 @@ Both mutations and queries can be handled by root resolvers, so the root that im
 ```javascript
 var fakeDatabase = {};
 var root = {
-  setMessage: function({message}) {
+  setMessage: function ({message}) {
     fakeDatabase.message = message;
   }
-  getMessage: function() {
+  getMessage: function () {
     return fakeDatabase.message;
   }
 };
@@ -87,16 +87,16 @@ var fakeDatabase = {};
 
 // The root provides the top-level API endpoints
 var root = {
-  getMessage: function({author}) {
+  getMessage: function ({author}) {
     return fakeDatabase[author];
   },
-  createMessage: function({message}) {
+  createMessage: function ({message}) {
     if (fakeDatabase[message.author]) {
       throw new Error('a message already exists with this author');
     }
     fakeDatabase[message.author] = message.content;
   },
-  updateMessage: function({message}) {
+  updateMessage: function ({message}) {
     if (!fakeDatabase[message.author]) {
       throw new Error('no message exists with this author');
     }

site/docs/Tutorial-ObjectTypes.md

@@ -50,7 +50,7 @@ class RandomDie {
 }
 
 var root = {
-  getDie: function({numSides}) {
+  getDie: function ({numSides}) {
     return new RandomDie(numSides || 6);
   }
 }
@@ -111,7 +111,7 @@ class RandomDie {
 
 // The root provides the top-level API endpoints
 var root = {
-  getDie: function({numSides}) {
+  getDie: function ({numSides}) {
     return new RandomDie(numSides || 6);
   }
 }

site/docs/Tutorial-PassingArguments.md

@@ -28,7 +28,7 @@ So far, our resolver functions took no arguments. When a resolver takes argument
 
 ```javascript
 var root = {
-  rollDice: function(args) {
+  rollDice: function (args) {
     var output = [];
     for (var i = 0; i < args.numDice; i++) {
       output.push(1 + Math.floor(Math.random() * (args.numSides || 6)));
@@ -42,7 +42,7 @@ It's convenient to use [ES6 destructuring assignment](https://developer.mozilla.
 
 ```javascript
 var root = {
-  rollDice: function({numDice, numSides}) {
+  rollDice: function ({numDice, numSides}) {
     var output = [];
     for (var i = 0; i < numDice; i++) {
       output.push(1 + Math.floor(Math.random() * (numSides || 6)));
@@ -70,7 +70,7 @@ var schema = buildSchema(`
 
 // The root provides a resolver function for each API endpoint
 var root = {
-  rollDice: function({numDice, numSides}) {
+  rollDice: function ({numDice, numSides}) {
     var output = [];
     for (var i = 0; i < numDice; i++) {
       output.push(1 + Math.floor(Math.random() * (numSides || 6)));