Model Store and Collection Store

Author: letitia

_collection-store/cache.md

@@ -3,5 +3,5 @@ header: cache
 example: CollectionStore.cache
 ---
 
-An object of collections to store data in memory to reduce the number of round trips to the API.  Overriding data or modifying the cache is not recommended, however it is helpful to inspect data.
+An object of collections that stores data in memory to reduce the number of round trips to the API.  Overriding data or modifying the cache is not recommended, but it is helpful for inspecting the data.
 

_collection-store/clear.md

@@ -3,5 +3,5 @@ header: clear
 example: CollectionStore.clear([collectionName], [params])
 ---
 
-Clears the collection from the cache.  Passing both parameters will clear a specific collection, that matches the `collectionName` and `params`.  Passing only the `collectionName` will clear all instances of that collection. Passing no parameters will clear all collections from the store.
+Removes the collection from the cache.  Passing both parameters will clear a specific collection that matches the `collectionName` and `params`.  Passing only the `collectionName` will clear all instances of that collection.  Passing no parameters will clear all collections from the store.
 

_collection-store/expireSeconds.md

@@ -3,4 +3,4 @@ header: expireSeconds
 example: CollectionStore.expireSeconds
 ---
 
-The time in seconds the collection will live in the store for.  By default this is set to `null`, so the data will not expire until a page reload.
+The length of time that the collection will be stored, in seconds.  By default this is set to `null`, so the data will not expire until the page is reloaded.

_collection-store/get.md

@@ -3,17 +3,17 @@ header: get
 example: CollectionStore.get(collectionName, params, [callback])
 ---
 
-Returns the collection from the store based on the collection name and it's [params](/collection#params).
+Returns the collection from the store based on the collection name and its [params](/collection#params).
 
 You can also use the `get` function asynchronously by passing a `callback` function.
 
 ```js
 // async
-fetcher.collectionStore.get('users', {ids: [1,2,3]}, function (result) {
-  // can access the users in the result
+fetcher.collectionStore.get('UsersCollection', { ids: [1,2,3] }, function (result) {
+  // do something with the users
 });
 
 // sync
-var result = fetcher.collectionStore.get('users', { ids: [1,2,3] })
+var result = fetcher.collectionStore.get('UsersCollection', { ids: [1,2,3] })
 
 ```

_collection-store/set.md

@@ -3,4 +3,4 @@ header: set
 example: CollectionStore.set(collection, params)
 ---
 
-Adds the collection to the [cache](#cache).  The params for the collection are required to use as part of a unique identifier for the collection.
+Adds the collection to the [cache](#cache).  The params for the collection are used as part of a unique identifier for the collection.

_model-store/cache.md

@@ -3,5 +3,5 @@ header: cache
 example: ModelStore.cache
 ---
 
-An object of models to store data in memory to reduce the number of round trips to the API.  Overriding data or modifying the cache is not recommended, however it is helpful to inspect data.
+An object of models that stores data in memory to reduce the number of round trips to the API.  Overriding data or modifying the cache is not recommended, but it is helpful for inspecting the data.
 

_model-store/clear.md

@@ -3,5 +3,5 @@ header: clear
 example: ModelStore.clear([modelName], [id])
 ---
 
-Removes the model(s) from the [cache](#cache).  If you pass both the `modelName` and the `id` it will clear that model from the store. If you only pass the `modelName` it will clear all of the models of that type in the store. Passing no arguments will clear the entire model store.
+Removes the model(s) from the [cache](#cache).  If you pass both the `modelName` and the `id` it will clear that model from the store.  If you only pass the `modelName` it will clear all of the models of that type in the store.  Passing no arguments will clear the entire model store.
 

_model-store/expireSeconds.md

@@ -3,4 +3,4 @@ header: expireSeconds
 example: ModelStore.expireSeconds
 ---
 
-The time in seconds the model will live in the store for.  By default this is set to `null`, so the data will not expire until a page reload.
+The length of time that the model will be stored, in seconds.  By default this is set to `null`, so the data will not expire until the page is reloaded.

_model-store/find.md

@@ -3,5 +3,9 @@ header: find
 example: ModelStore.find(modelName, attrs)
 ---
 
-Returns the first instance found that matches the `modelName` and `attrs` sent.  The `modelName` is the name of the model, the `attrs` is an object of attributes that the model is trying to find.
+Returns the first instance found that matches the `modelName` and `attrs` sent.  The `modelName` is the name of the model, the `attrs` is an object of parameters to search on.
 
+Example:
+```js
+modelStore.find('Media', { type': 'photo', 'id': 16 })
+```

_model-store/get.md

@@ -3,4 +3,4 @@ header: get
 example: ModelStore.get(modelName, id)
 ---
 
-Returns the model from the store. Requires the name of the model and the model's `id`.
+Returns the model from the store.  Requires the name of the model and the model's `id`.