cleaning up some formatting and adding clarifications.

Author: neilvyas

examples/RethinkDB.md

@@ -2,43 +2,44 @@
 
 RethinkDb offers a batching method called `getAll` but there are a few caveats :
 * Order of results is not guaranteed ([rethinkdb/rethinkdb#5187](https://github.com/rethinkdb/rethinkdb/issues/5187))
-* Non-existent keys will not return and empty record
-Assuming a table `example_table` with those records :
+* Non-existent keys will not return an empty record
+
+For example, against a table `example_table` with these records:
 ```js
 [
   {"id": 1, "name": "Document 1"},
   {"id": 2, "name": "Document 2"}
 ]
 ```
-A query `r.getAll(1, 2, 3)` could return such an array :
+A query `r.getAll(1, 2, 3)` could return:
 ```js
 [
   {"id": 2, "name": "Document 2"},
   {"id": 1, "name": "Document 1"}
 ]
 ```
 
-In essence, this naive implementation won't work :
+Because query keys and values are associated by position in the dataloader cache, this naive implementation won't work (with the same table as above):
 ```js
 var r = require('rethinkdb');
 var db = await r.connect();
 
 var batchLoadFn = keys => db.table('example_table').getAll(...keys).then(res => res.toArray());
 var exampleLoader = new DataLoader(batchLoadFn);
 
-await exampleLoader.loadMany([1, 2, 3]); // Throws, values length !== keys length
+await exampleLoader.loadMany([1, 2, 3]); // Throws values length !== keys length
 
 await exampleLoader.loadMany([1, 2]);
 await exampleLoader.load(1); // {"id": 2, "name": "Document 2"}
 ```
 
 A solution is to normalize results returned by `getAll` to match the structure of supplied `keys`.
 
-To achieve this efficiently, we first write an indexing function. This function will return a Map indexing results.
-Parameters :
-* `results` : Array of RethinkDb results
-* `indexField` : String indicating which field was used as index for this batch query
-* `cacheKeyFn` : Optional function used to serialize non-scalar index field values
+To achieve this efficiently, we first write an indexing function. This function will return a `Map` indexing results.
+Parameters:
+* `results`: Array of RethinkDb results
+* `indexField`: String indicating which field was used as index for this batch query
+* `cacheKeyFn`: Optional function used to serialize non-scalar index field values
 ```js
 function indexResults(results, indexField, cacheKeyFn = key => key) {
   var indexedResults = new Map();
@@ -58,7 +59,7 @@ function normalizeRethinkDbResults(keys, indexField, cacheKeyFn = key => key) {
 }
 ```
 
-Full dataloader implementation :
+Full dataloader implementation:
 ```js
 var r = require('rethinkdb');
 var db = await r.connect();