Merge pull request #113 from algoliareadmebot/master

Update README

Author: maxiloc

README.md

@@ -488,6 +488,7 @@ Parameters that can also be used in a setSettings also have the `indexing` [scop
 - [synonyms](#synonyms) `search`
 - [replaceSynonymsInHighlight](#replacesynonymsinhighlight) `search`, `settings`
 - [minProximity](#minproximity) `search`, `settings`
+- [responseFields](#responsefields) `search`, `settings`
 
 <!--/PARAMETERS_LINK-->
 
@@ -608,7 +609,7 @@ res = index.save_objects([{"firstname": "Jimmie",
                            "objectID": "myID2"}])
 ```
 
-To update a single object, you can use the `[Update object](#update-object---save_object) method:
+To update a single object, you can use the `save_object` method:
 
 ```python
 index.save_object({"firstname": "Jimmie", 
@@ -949,6 +950,7 @@ They are three scopes:
 - [placeholders](#placeholders) `settings`
 - [altCorrections](#altcorrections) `settings`
 - [minProximity](#minproximity) `search`, `settings`
+- [responseFields](#responsefields) `search`, `settings`
 
 ### Search
 
@@ -1927,6 +1929,25 @@ Considering the query *“javascript framework”*, if you set `minProximity=2`,
 
 **Note:** the maximum `minProximity` that can be set is 7. Any higher value will disable the `proximity` criterion from the ranking formula.
 
+#### responseFields
+
+- scope: `search`, `settings`
+- type: `array of strings`
+- default: `*`
+
+
+Choose which fields the response will contain. Applies to search and browse queries.
+
+By default, all fields are returned. If this parameter is specified, only the fields explicitly listed will be returned, unless `*` is used, in which case all fields are returned. Specifying an empty list or unknown field names is an error.
+
+This parameter is mainly intended to limit the response size. For example, for complex queries, echoing of request parameters in the response's `params` field can be undesirable.
+
+Some fields cannot be filtered out:
+
+- warning `message`
+- `cursor` in browse queries
+- fields triggered explicitly via [getRankingInfo](#getrankinginfo)
+
 
 ## Manage Indices