Updated java sample instructions

So they match the instructions in the Event Streams getting started documentation.
No change made to the actual objective of the sample.

Author: Ziad Abass

kafka-java-console-sample/docs/Local.md

@@ -4,28 +4,133 @@ As pushing the application into IBM Cloud® does not require you to build the ap
 We will not discuss establishing a connection from your laptop to Event Streams for IBM Cloud. This is described in the [connection guide](https://cloud.ibm.com/docs/services/EventStreams?topic=eventstreams-connecting#connecting).
 
 ## Prerequisites
-* Provision an [Event Streams Service Instance](https://cloud.ibm.com/catalog/services/event-streams) in [IBM Cloud®](https://cloud.ibm.com/)
-* Install [Gradle 4+](https://gradle.org/)
-* Install Java 7+
 
-## Build the Sample
-Build the project using gradle:
-```shell
-gradle clean build
- ```
+1. **If you don't already have one, create an Event Streams service instance.**
 
-The command above creates a jar file under `build/libs`.
+   1. Log in to the IBM Cloud console.
+  
+   2. Click **Catalog**.
+  
+    3. From the navigation pane, click **Integration**, click the **Event Streams** tile, and then select the **Lite plan**. The Event Streams service instance page opens.
+  
+   4. Enter a name for your service. You can use the default value.
+  
+   5. Click **Create**. The Event Streams **Getting started** page opens. 
 
-## Running the Sample
-Once built, to run the sample, execute the following command:
-```shell
-java -jar ./build/libs/kafka-java-console-sample-2.0.jar <kafka_brokers_sasl> <api_key>
-```
+2. **If you don't already have them, install the following prerequisites:**
+	
+	* [git](https://git-scm.com/)
+	* [Gradle](https://gradle.org/)
+	* Java 8 or higher
 
-To find the values for `<kafka_brokers_sasl>` and `<api_key>`, access your Event Streams instance in IBM Cloud®, go to the `Service Credentials` tab and select the `Credentials` you want to use.
 
-__Note__: `<kafka_brokers_sasl>` must be a single string enclosed in quotes. For example: `"host1:port1,host2:port2"`. We recommend using all the Kafka hosts listed in the `Credentials` you selected.
 
-Alternatively, you can run only the producer or only the consumer by respectively appending the switches `-producer` or `-consumer`  to the command above.
+## Steps to Build the Sample
 
-The sample will run indefinitely until interrupted. To stop the process, use `Ctrl+C`.
+### 1. **Create a topic**
+
+   The topic is the core of Event Streams flows. Data passes through a topic from producing applications to consuming applications. 
+
+   We'll be using the IBM Cloud console (UI) to create the topic, and will reference it when starting the application.
+
+   1. Go to the **Topics** tab.
+  
+   2. Click **New topic**.
+  
+   3. Name your topic.
+  
+        > The sample application is configured to connect to topic `kafka-java-console-sample-topic`. If the topic does not exist, it is created when the application is started. 
+
+   4. Keep the defaults set in the rest of the topic creation, click **Next** and then **Create topic**.
+
+   5. The topic appears in the table. Congratulations, you have created a topic!
+
+---
+
+### 2. **Create credentials**
+
+   To allow the sample application to access your topic, we need to create some credentials for it. 
+
+   1. Go to **Service credentials** in the navigation pane.
+  
+   2. Click **New credential**.
+  
+   3. Give the credential a name so you can identify its purpose later. You can accept the default value.
+  
+   4. Give the credential the **Manager** role so that it can access the topics, and create them if necessary. 
+  
+   5. Click **Add**. The new credential is listed in the table in **Service credentials**.
+  
+   6. Click **View credentials** to see the `api_key` and `kafka_brokers_sasl` values.
+
+---
+
+### 3. **Clone the Github repository for the sample application**
+
+   The sample application is stored here. Clone the `event-streams-samples` repository by running the clone command from the command line. 
+
+   ```
+    git clone https://github.com/ibm-messaging/event-streams-samples.git
+   ```
+
+   <br/>
+   When the repository is cloned, from the command line change into the <code>kafka-java-console-sample</code> directory.
+
+   ```
+   cd event-streams-samples/kafka-java-console-sample
+   ```
+
+   <br/>
+   Build the contents of the <code>kafka-java-console-sample</code> directory.
+
+   ```
+   gradle clean && gradle build
+   ```
+---
+
+### 4.  **Run the consuming application**
+   
+   Start the sample consuming application from the command line, replacing the `kafka_brokers_sasl` and `api_key` values. 
+
+   The `java -jar ./build/libs/kafka-java-console-sample-2.0.jar` part of the command identifies the locations of the .JAR file to run within the cloned repository. You do not need to change this. 
+   
+   Use the `kafka_brokers_sasl` from the **Service credentials** created in Step 2. We recommend using all the `kafka_brokers_sasl` listed in the **Service credentials** that you created.
+
+   >The `kafka_brokers_sasl` must be formatted as `"host:port,host2:port2"`. </br> Format the contents of `kafka_brokers_sasl` in a text editor before entering it in the command line.
+
+   Then, use the `api_key` from the **Service credentials** created in Step 2. `-consumer` specifies that the consumer should start. 
+
+   ```
+   java -jar ./build/libs/kafka-java-console-sample-2.0.jar 
+   <kafka_brokers_sasl> <api_key> -consumer
+   ```
+
+   An `INFO No messages consumed` is displayed when the consuming application is running, but there is no data being consumed. 
+
+---
+
+### 5. **Run the producing application**
+
+   Open a new command line window and change into the <code>kafka-java-console-sample</code> directory.
+
+   ```
+   cd event-streams-samples/kafka-java-console-sample
+   ```
+   
+   Then, start the sample producing application from the command line, replacing the `kafka_brokers_sasl` and `api_key` values with the same ones used to run the consumer.
+
+   Use the `api_key` from the **Service credentials** created in Step 2. `-producer` specifies that the producer should start. 
+
+   ```
+   java -jar ./build/libs/kafka-java-console-sample-2.0.jar
+	<kafka_brokers_sasl> <api_key> -producer
+   ```
+
+---
+
+### 6. **Success!**
+
+   When the producer starts, messages are produced to the topic. Messages are then consumed from the topic by the consuming application.
+   You can verify the successful flow of messages when you see `INFO Message consumed` from the consumer. 
+
+   The sample runs indefinitely until you stop it. To stop the process, run an exit command `Ctrl+C`.