clean up descriptions of imports

Author: lacker

site/graphql-js/APIReference-Errors.md

@@ -7,12 +7,12 @@ sublinks: formatError,GraphQLError,locatedError,syntaxError
 next: /docs/api-reference-execution/
 ---
 
-The `graphql/error` module is responsible for creating and formating
-GraphQL errors.
+The `graphql/error` module is responsible for creating and formatting
+GraphQL errors. You can import either from the `graphql/error` module, or from the root `graphql` module. For example:
 
 ```js
-import { ... } from 'graphql/error'; // ES6
-var GraphQLError = require('graphql/error'); // CommonJS
+import { GraphQLError } from 'graphql'; // ES6
+var { GraphQLError } = require('graphql'); // CommonJS
 ```
 
 ## Overview

site/graphql-js/APIReference-Execution.md

@@ -8,11 +8,11 @@ next: /docs/api-reference-language/
 ---
 
 The `graphql/execution` module is responsible for the execution phase of
-fulfilling a GraphQL request.
+fulfilling a GraphQL request. You can import either from the `graphql/execution` module, or from the root `graphql` module. For example:
 
 ```js
-import { execute } from 'graphql/execution'; // ES6
-var GraphQLExecution = require('graphql/execution'); // CommonJS
+import { execute } from 'graphql'; // ES6
+var { execute } = require('graphql'); // CommonJS
 ```
 
 ## Overview

site/graphql-js/APIReference-GraphQL.md

@@ -11,8 +11,8 @@ The `graphql` module exports a core subset of GraphQL functionality for creation
 of GraphQL type systems and servers.
 
 ```js
-import { ... } from 'graphql'; // ES6
-var GraphQL = require('graphql'); // CommonJS
+import { graphql } from 'graphql'; // ES6
+var { graphql } = require('graphql'); // CommonJS
 ```
 
 ## Overview

site/graphql-js/APIReference-Language.md

@@ -7,12 +7,11 @@ sublinks: BREAK,getLocation,Kind,lex,parse,parseValue,printSource,visit
 next: /docs/api-reference-type-system/
 ---
 
-The `graphql/language` module is responsible for parsing and operating on the
-GraphQL language.
+The `graphql/language` module is responsible for parsing and operating on the GraphQL language. You can import either from the `graphql/language` module, or from the root `graphql` module. For example:
 
 ```js
-import { ... } from 'graphql/language'; // ES6
-var GraphQLLanguage = require('graphql/language'); // CommonJS
+import { Source } from 'graphql'; // ES6
+var { Source } = require('graphql'); // CommonJS
 ```
 
 ## Overview

site/graphql-js/APIReference-TypeSystem.md

@@ -7,11 +7,11 @@ sublinks: getNamedType,getNullableType,GraphQLBoolean,GraphQLEnumType,GraphQLFlo
 next: /docs/api-reference-utilities/
 ---
 
-The `graphql/type` module is responsible for defining GraphQL types and schema.
+The `graphql/type` module is responsible for defining GraphQL types and schema. You can import either from the `graphql/type` module, or from the root `graphql` module. For example:
 
 ```js
-import { ... } from 'graphql/type'; // ES6
-var GraphQLType = require('graphql/type'); // CommonJS
+import { GraphQLSchema } from 'graphql'; // ES6
+var { GraphQLSchema } = require('graphql'); // CommonJS
 ```
 
 ## Overview

site/graphql-js/APIReference-Utilities.md

@@ -8,11 +8,11 @@ next: /docs/api-reference-validation/
 ---
 
 The `graphql/utilities` module contains common useful computations to use with
-the GraphQL language and type objects.
+the GraphQL language and type objects. You can import either from the `graphql/utilities` module, or from the root `graphql` module. For example:
 
 ```js
-import { ... } from 'graphql/utilities'; // ES6
-var GraphQLUtilities = require('graphql/utilities'); // CommonJS
+import { introspectionQuery } from 'graphql'; // ES6
+var { introspectionQuery } = require('graphql'); // CommonJS
 ```
 
 ## Overview

site/graphql-js/APIReference-Validation.md

@@ -7,11 +7,11 @@ sublinks: specifiedRules,validate
 ---
 
 The `graphql/validation` module fulfills the Validation phase of fulfilling a
-GraphQL result.
+GraphQL result. You can import either from the `graphql/validation` module, or from the root `graphql` module. For example:
 
 ```js
 import { validate } from 'graphql/validation'; // ES6
-var GraphQLValidator = require('graphql/validation'); // CommonJS
+var { validate } = require('graphql/validation'); // CommonJS
 ```
 
 ## Overview