docs(cookbook/graphql): edits up to Performing a Mutation

Author: kapunahelewong

public/docs/ts/latest/cookbook/graphql.jade

@@ -323,8 +323,8 @@ code-example(language="sh" class="code-shell").
   With GraphQL you always query a server that has a schema representing the data it exposes. 
   A schema is or serves as a ...
 
-  The server for this guide is based on the [Tour of Heroes](link here please). The schema 
-  is as follows:
+  The server for this guide is based on the [Tour of Heroes](link here please). 
+  Copy the schema that follows into a file named `in-memory-graphql.ts` in the `app` directory:
 
 .alert.is-important
   :marked
@@ -350,26 +350,56 @@ code-example(language="sh" class="code-shell").
     possible that I have missed some. I haven't gone into the `_example` files.
 
 +makeExample('heroes-graphql/ts/src/app/in-memory-graphql.ts', 'graphql-schema', 'app/in-memory-graphql.ts')
-:marked
-  Copy the schema into a file named `in-memory-graphql.ts` in the app directory.
 
-  To use the schema, start by importing Apollo into `heroes.component.ts`, 
+:marked
+  To use the schema, start by importing `Apollo` into `heroes.component.ts`, 
   and injecting it into the constructor:
-+makeExample('heroes-graphql/ts/src/app/heroes.component.ts', 'import-apollo', 'heroes.component.ts')
-+makeExample('heroes-graphql/ts/src/app/heroes.component.ts', 'inject-apollo', 'heroes.component.ts')
++makeExample('heroes-graphql/ts/src/app/heroes.component.ts', 'import-apollo', 'heroes.component.ts (excerpt)')
++makeExample('heroes-graphql/ts/src/app/heroes.component.ts', 'inject-apollo', 'heroes.component.ts (excerpt)')
 :marked
-  To query data with the Apollo client, pass Apollo a query in the GraphQL 
-  query syntax, explained [here](http://graphql.org/learn/queries/).
+  Now that the schema is available to the app, the next step is querying it. 
+  In the component, import `gql` from the `graphql-tag` library. 
+  The `gql` function parses regular string literals as GraphQL.
+
+.alert.is-important
+  :marked
+    Uri: Could you explain in just a sentence or two what it means when 
+    we parse string literals as GraphQL? 
 
-  In order to parse regular string literals as GraphQL, we will use the `gql` function from the `graphql-tag` library:
 +makeExample('heroes-graphql/ts/src/app/heroes.component.ts', 'import-graphql-tag', 'heroes.component.ts')
+
 :marked
-  Now let's query:
+  To query data with the Apollo Client, pass `Apollo` a query in the GraphQL 
+  query syntax. In this example, ...... 
+.alert.is-important
+  :marked
+    Uri: Could you give a brief explanation of what's happening in the below 
+    code snippet? Please touch on if we are putting it in the component (I think so),
+    and what each section means. This is a really important part of this tutorial and 
+    people will be very interested in the unique syntax. Brief is fine, since we don't 
+    want to go too far into it, but we should exaplain on this page what each line means. 
+    This might be 2 or 3 short paragraphs. Please also touch on the use of observables. 
+    You can say something to the effect that we are using observables here because x and 
+    they can tell that because of `subscribe`. You could include a link to ....(I'm finding the right link...). 
+
 +makeExample('heroes-graphql/ts/src/app/heroes.component.ts', 'query-heroes', 'heroes.component.ts')
+
 :marked
-  and render:
+  For more information on GraphQL queries, see the GraphQL documentation on 
+  [Queries and Mutations](http://graphql.org/learn/queries/).
+:marked
+  Next, update the template so it will display the results of the query.
 +makeExample('heroes-graphql/ts/src/app/heroes.component.1.html', 'render-heroes', 'heroes.component.html')
 
+.alert.is-important
+  :marked
+    Uri: 
+
+    1. Since we haven't talked about the template yet, do you think we should show 
+    the whole thing with some comments making this section (above) stand out?
+
+    2. Do the results show up at this point? If so, maybe we should mention that. If not, 
+    we should say so.
 
 .l-main-section
 <a id="mutation"></a>