Review README

Author: jzsimbiose

README.md

@@ -25,6 +25,13 @@ npm install slicerjs
 
 ## Usage
 
+The following code snippet is an example of how to add and query data
+using the SlicingDice javascript client. We entry data informing
+'[email protected]' has age 22 and then query the database for
+the number of users with age between 20 and 40 years old.
+If this is the first register ever entered into the system,
+ the answer should be 1.
+
 ```javascript
 var SlicingDice = require('slicerjs'); // only required for Node.js
 
@@ -344,7 +351,7 @@ client.countEntityTotal().then((resp) => {
 ```
 
 ### `countEntity(jsonData)`
-Count the number of entities attending the given query. This method corresponds to a [POST request at /query/count/entity](http://panel.slicingdice.com/docs/#api-details-api-endpoints-post-query-count-entity).
+Count the number of entities matching the given query. This method corresponds to a [POST request at /query/count/entity](http://panel.slicingdice.com/docs/#api-details-api-endpoints-post-query-count-entity).
 
 #### Request example
 
@@ -401,7 +408,7 @@ client.countEntity(query).then((resp) => {
 ```
 
 ### `countEvent(jsonData)`
-Count the number of occurrences for time-series events attending the given query. This method corresponds to a [POST request at /query/count/event](http://panel.slicingdice.com/docs/#api-details-api-endpoints-post-query-count-event).
+Count the number of occurrences for time-series events matching the given query. This method corresponds to a [POST request at /query/count/event](http://panel.slicingdice.com/docs/#api-details-api-endpoints-post-query-count-event).
 
 #### Request example
 
@@ -460,7 +467,7 @@ client.countEvent(query).then((resp) => {
 ```
 
 ### `topValues(jsonData)`
-Return the top values for entities attending the given query. This method corresponds to a [POST request at /query/top_values](http://panel.slicingdice.com/docs/#api-details-api-endpoints-post-query-top-values).
+Return the top values for entities matching the given query. This method corresponds to a [POST request at /query/top_values](http://panel.slicingdice.com/docs/#api-details-api-endpoints-post-query-top-values).
 
 #### Request example
 
@@ -863,7 +870,7 @@ client.deleteSavedQuery("my-saved-query").then((resp) => {
 ```
 
 ### `result(jsonData)`
-Retrieve indexed values for entities attending the given query. This method corresponds to a [POST request at /data_extraction/result](http://panel.slicingdice.com/docs/#api-details-api-endpoints-post-data-extraction-result).
+Retrieve indexed values for entities matching the given query. This method corresponds to a [POST request at /data_extraction/result](http://panel.slicingdice.com/docs/#api-details-api-endpoints-post-data-extraction-result).
 
 #### Request example
 
@@ -922,7 +929,7 @@ client.result(query).then((resp) => {
 ```
 
 ### `score(jsonData)`
-Retrieve indexed values as well as their relevance for entities attending the given query. This method corresponds to a [POST request at /data_extraction/score](http://panel.slicingdice.com/docs/#api-details-api-endpoints-post-data-extraction-score).
+Retrieve indexed values as well as their relevance for entities matching the given query. This method corresponds to a [POST request at /data_extraction/score](http://panel.slicingdice.com/docs/#api-details-api-endpoints-post-data-extraction-score).
 
 #### Request example