Merge pull request #17 from oslabs-beta/readme

Readme Fixes

Author: DavidMNorman

README.md

@@ -9,8 +9,6 @@
 	<a href="https://twitter.com/intent/tweet?text=Meet%20Obsidian!%20Deno's%20first%20native%20GraphQL%20caching%20client%20and%20server%20module&url=http://obsidian.land/&via=obsidian_land&hashtags=deno,denoland,nodejs,graphql,javascript" rel="nofollow"><img src="https://camo.githubusercontent.com/83d4084f7b71558e33b08844da5c773a8657e271/68747470733a2f2f696d672e736869656c64732e696f2f747769747465722f75726c2f687474702f736869656c64732e696f2e7376673f7374796c653d736f6369616c" alt="Tweet" data-canonical-src="https://img.shields.io/twitter/url/http/shields.io.svg?style=social" style="max-width:100%;"></a>
 </h1>
 
-<p align="center">from <em align="center">Lascaux</em></p>
-
 </div>
 
 <p align="center">
@@ -26,8 +24,8 @@
 - (New!) Option to provide Obsidian with the search types your application uses, allowing data cached from complete dataset pulls to be accessible later on in searches for individual items
 - (New!) Refactored server-side caching with Redis
 - (New!) Rebuilt developer tool for Obsidian 8.0 for testing and analytics related to the new client caching options
-- (New!) Option for persistant queries, allowing only a smaller hash to be sent to the server on client-side cache misses, minimizing the cost of queries. Note that while this will increase the performance for frequent, repeat queries, you may see a performance drop for new queries that haven't yet been persisted
-- Flexible cache responds with only data requested from selected fields
+- (New!) Option for persistent queries, allowing only a smaller hash to be sent to the server on client-side cache misses, minimizing the cost of queries. Note that while this will increase the overall performance for frequent, repeat queries.
+- Flexible cache responds only with data requested from selected fields
 - GraphQL query abstraction and caching improving the performance of your app
 - SSR React wrapper, allowing you to cache in browser
 - Configurable caching options, giving you complete control over your cache
@@ -63,12 +61,12 @@ const GraphQLRouter =
   (await ObsidianRouter) <
   ObsRouter >
   {
-    Router,
+    Router, // your router in deno
     typeDefs: types, // graphQL typeDefs
     resolvers: resolvers, // graphQL resolvers
   };
 
-// attach the graphql routers routes to our app
+// attach the graphql router's routes to your deno app
 app.use(GraphQLRouter.routes(), GraphQLRouter.allowedMethods());
 ```
 ## Selecting options for the Router
@@ -86,8 +84,8 @@ const GraphQLRouter =
     redisPort: 6379, // Desired redis port, default to 6379
     policy: 'allkeys-lru', // Option select your Redis policy, default to allkeys-lru
     maxmemory = '2000mb', // Option to select Redis capacity, default to 2000mb
-    searchTerms: [] //Optional array to allow board queries to store according to search fields so individual searches are found in cache
-    persistQueries: true, //Boolean to toggle the use of persistant queries, default to false
+    searchTerms: [] //Optional array to allow broad queries to store according to search fields so individual searches are found in cache
+    persistQueries: true, //Boolean to toggle the use of persistent queries, default to false - NOTE: if using, must also be enabled in client wrapper
     hashTableSize = 16, // Size of hash table for persistent queries, default to 16
     maxQueryDepth = 0, // Maximum depth of query, default to 0
     customIdentifier: ['__typename', '_id'], // keys to be used to idedntify and normalize object