Update README [skip ci] (#412)

Author: algolia-bot

README.md

@@ -7,7 +7,7 @@ The **Algolia Search API Client for Android** lets you easily use the [Algolia S
 _Note: If you were using **version 2.x** of our Android client, read the [migration guide to version 3.x](https://github.com/algolia/algoliasearch-client-android/wiki/Migration-guide-to-version-3.x)._
 
 
-As a complement to this readme, you can browse the automatically generated [reference documentation](https://community.algolia.com/algoliasearch-client-android/).
+You can browse the automatically generated [reference documentation](https://community.algolia.com/algoliasearch-client-android/).
 (See also the [offline-enabled version](https://community.algolia.com/algoliasearch-client-android/offline/).)
 
 This project is open-source under the [MIT License](./LICENSE).
@@ -35,11 +35,19 @@ You can find the full reference on [Algolia's website](https://www.algolia.com/d
 1. **[Quick Start](#quick-start)**
 
     * [Initialize the client](#initialize-the-client)
-    * [Push data](#push-data)
-    * [Search](#search)
-    * [Configure](#configure)
 
-1. **[Getting Help](#getting-help)**
+1. **[Push data](#push-data)**
+
+
+1. **[Configure](#configure)**
+
+
+1. **[Search](#search)**
+
+
+1. **[Search UI](#search-ui)**
+
+    * [index.html](#indexhtml)
 
 
 
@@ -49,9 +57,10 @@ You can find the full reference on [Algolia's website](https://www.algolia.com/d
 
 
 
+
 ## Install
 
-Add the following dependency to your Gradle build file:
+Add the following dependency to your `Gradle` build file:
 
 ```gradle
 dependencies {
@@ -66,14 +75,19 @@ In 30 seconds, this quick start tutorial will show you how to index and search o
 
 ### Initialize the client
 
-You first need to initialize the client. For that you need your **Application ID** and **API Key**.
-You can find both of them on [your Algolia account](https://www.algolia.com/api-keys).
+To begin, you will need to initialize the client. In order to do this you will need your **Application ID** and **API Key**.
+You can find both on [your Algolia account](https://www.algolia.com/api-keys).
 
 ```java
-Client client = new Client("YOUR_APP_ID", "YOUR_API_KEY");
+Client client = new Client("YourApplicationID", "YourAPIKey");
+Index index = client.getIndex("your_index_name");
 ```
 
-### Push data
+**Warning:** If you are building a native app on mobile, be sure to **not include** the search API key directly in the source code.
+ You should instead consider [fetching the key from your servers](https://www.algolia.com/doc/guides/security/best-security-practices/#api-keys-in-mobile-applications)
+ during the app's startup.
+
+## Push data
 
 Without any prior configuration, you can start indexing contacts in the ```contacts``` index using the following code:
 
@@ -91,9 +105,31 @@ index.addObjectAsync(new JSONObject()
       .put("company", "Norwalk Crmc"), null);
 ```
 
-### Search
+## Configure
+
+Settings can be customized to fine tune the search behavior. For example, you can add a custom sort by number of followers to further enhance the built-in relevance:
+
+```java
+JSONObject settings = new JSONObject().append("customRanking", "desc(followers)");
+index.setSettingsAsync(settings, null);
+```
+
+You can also configure the list of attributes you want to index by order of importance (most important first).
 
-You can now search for contacts using firstname, lastname, company, etc. (even with typos):
+**Note:** The Algolia engine is designed to suggest results as you type, which means you'll generally search by prefix.
+In this case, the order of attributes is very important to decide which hit is the best:
+
+```java
+JSONObject settings = new JSONObject()
+    .append("searchableAttributes", "lastname")
+    .append("searchableAttributes", "firstname")
+    .append("searchableAttributes", "company");
+index.setSettingsAsync(settings, null);
+```
+
+## Search
+
+You can now search for contacts using `firstname`, `lastname`, `company`, etc. (even with typos):
 
 ```java
 CompletionHandler completionHandler = new CompletionHandler() {
@@ -112,26 +148,74 @@ index.searchAsync(new Query("california paint"), completionHandler);
 index.searchAsync(new Query("jimmie paint"), completionHandler);
 ```
 
-### Configure
-
-Settings can be customized to tune the search behavior. For example, you can add a custom sort by number of followers to the already great built-in relevance:
-
-```java
-JSONObject settings = new JSONObject().append("customRanking", "desc(followers)");
-index.setSettingsAsync(settings, null);
+## Search UI
+
+**Warning:** If you are building a web application, you may be more interested in using one of our
+[frontend search UI libraries](https://www.algolia.com/doc/guides/search-ui/search-libraries/)
+
+The following example shows how to build a front-end search quickly using
+[InstantSearch.js](https://community.algolia.com/instantsearch.js/)
+
+### index.html
+
+```html
+<!doctype html>
+<head>
+  <meta charset="UTF-8">
+  <link rel="stylesheet" href="https://cdn.jsdelivr.net/instantsearch.js/1/instantsearch.min.css">
+</head>
+<body>
+  <header>
+    <div>
+       <input id="search-input" placeholder="Search for products">
+       <!-- We use a specific placeholder in the input to guides users in their search. -->
+    
+  </header>
+  <main>
+      
+      
+  </main>
+
+  <script type="text/html" id="hit-template">
+    
+      <p class="hit-name">{{{_highlightResult.firstname.value}}} {{{_highlightResult.lastname.value}}}</p>
+    
+  </script>
+
+  <script src="https://cdn.jsdelivr.net/instantsearch.js/1/instantsearch.min.js"></script>
+  <script src="app.js"></script>
+</body>
 ```
 
-You can also configure the list of attributes you want to index by order of importance (first = most important):
-
-**Note:** Since the engine is designed to suggest results as you type, you'll generally search by prefix.
-In this case the order of attributes is very important to decide which hit is the best:
+### app.js
+
+```js
+var search = instantsearch({
+  // Replace with your own values
+  appId: 'YourApplicationID',
+  apiKey: 'YourSearchOnlyAPIKey', // search only API key, no ADMIN key
+  indexName: 'contacts',
+  urlSync: true
+});
+
+search.addWidget(
+  instantsearch.widgets.searchBox({
+    container: '#search-input'
+  })
+);
+
+search.addWidget(
+  instantsearch.widgets.hits({
+    container: '#hits',
+    hitsPerPage: 10,
+    templates: {
+      item: document.getElementById('hit-template').innerHTML,
+      empty: "We didn't find any results for the search <em>\"{{query}}\"</em>"
+    }
+  })
+);
 
-```java
-JSONObject settings = new JSONObject()
-    .append("searchableAttributes", "lastname")
-    .append("searchableAttributes", "firstname")
-    .append("searchableAttributes", "company");
-index.setSettingsAsync(settings, null);
+search.start();
 ```
 
 ## Getting Help