Fix some styles in README.md
diff --git a/README.md b/README.md
index 27140eb..0946c8c 100644
--- a/README.md
+++ b/README.md
@@ -3,29 +3,23 @@
Hello Samza is a starter project for [Apache Samza](http://samza.apache.org/) jobs.
-Please see [Hello Samza](http://samza.apache.org/startup/hello-samza/0.13/) and [Hello Samza High Level API](http://samza.apache.org/learn/tutorials/latest/hello-samza-high-level-yarn.html) to get started.
-
-### Pull requests and questions
+### About
[Hello Samza](http://samza.apache.org/startup/hello-samza/0.13/) is developed as part of the [Apache Samza](http://samza.apache.org) project. Please direct questions, improvements and bug fixes there. Questions about [Hello Samza](http://samza.apache.org/startup/hello-samza/0.13/) are welcome on the [dev list](http://samza.apache.org/community/mailing-lists.html) and the [Samza JIRA](https://issues.apache.org/jira/browse/SAMZA) has a hello-samza component for filing tickets.
-### Contribution
-
-To start contributing on [Hello Samza](http://samza.apache.org/startup/hello-samza/0.13/) first read [Rules](http://samza.apache.org/contribute/rules.html) and [Contributor Corner](https://cwiki.apache.org/confluence/display/SAMZA/Contributor%27s+Corner). Notice that [Hello Samza](http://samza.apache.org/startup/hello-samza/0.13/) git repository does not support git pull request.
-
### Instructions
-The **Hello Samza** project contains example Samza applications of high-level API as well as low-level API. The following are the instructions to install the binaries and run the applications in a local Yarn cluster.
+The **Hello Samza** project contains example Samza applications of high-level API as well as low-level API. The following are the instructions to install the binaries and run the applications in a local Yarn cluster. See also [Hello Samza](http://samza.apache.org/startup/hello-samza/0.13/) and [Hello Samza High Level API](http://samza.apache.org/learn/tutorials/latest/hello-samza-high-level-yarn.html) for more information.
#### 1. Get the Code
Check out the hello-samza project:
-{% highlight bash %}
+```
git clone https://git.apache.org/samza-hello-samza.git hello-samza
cd hello-samza
git checkout latest
-{% endhighlight %}
+```
This project contains everything you'll need to run your first Samza application.
@@ -33,9 +27,9 @@
A Samza grid usually comprises three different systems: [YARN](http://hadoop.apache.org/docs/current/hadoop-yarn/hadoop-yarn-site/YARN.html), [Kafka](http://kafka.apache.org/), and [ZooKeeper](http://zookeeper.apache.org/). The hello-samza project comes with a script called "grid" to help you setup these systems. Start by running:
-{% highlight bash %}
+```
./bin/grid bootstrap
-{% endhighlight %}
+```
This command will download, install, and start ZooKeeper, Kafka, and YARN. It will also check out the latest version of Samza and build it. All package files will be put in a sub-directory called "deploy" inside hello-samza's root folder.
@@ -49,19 +43,19 @@
NOTE: if you are building from the latest branch of hello-samza project, make sure that you run the following step from your local Samza project first:
-{% highlight bash %}
+```
git clone https://github.com/apache/samza.git
cd samza
./gradlew publishToMavenLocal
-{% endhighlight %}
+```
Then, you can continue w/ the following command in hello-samza project:
-{% highlight bash %}
+```
mvn clean package
mkdir -p deploy/samza
tar -xvf ./target/hello-samza-0.14.0-SNAPSHOT-dist.tar.gz -C deploy/samza
-{% endhighlight %}
+```
#### 4. Run a Samza Application
@@ -73,15 +67,15 @@
Package **samza.examples.wikipedia.application** contains a small Samza application which consumes the real-time feeds from Wikipedia, extracts the metadata of the events, and calculates statistics of all edits in a 10-second window. You can start the app on the grid using the run-app.sh script:
-{% highlight bash %}
+```
./deploy/samza/bin/run-app.sh --config-factory=org.apache.samza.config.factories.PropertiesConfigFactory --config-path=file://$PWD/deploy/samza/config/wikipedia-application.properties
-{% endhighlight %}
+```
Once the job is started, we can tail the kafka topic by:
-{% highlight bash %}
+```
./deploy/kafka/bin/kafka-console-consumer.sh --zookeeper localhost:2181 --topic wikipedia-stats
-{% endhighlight %}
+```
A code walkthrough of this application can be found [here](http://samza.apache.org/learn/tutorials/latest/hello-samza-high-level-code.html).
@@ -89,10 +83,14 @@
Package **samza.examples.wikipedia.task** contains the low-level API Samza code for the Wikipedia example. To run it, use the following scripts:
-{% highlight bash %}
+```
deploy/samza/bin/run-app.sh --config-factory=org.apache.samza.config.factories.PropertiesConfigFactory --config-path=file://$PWD/deploy/samza/config/wikipedia-feed.properties
deploy/samza/bin/run-app.sh --config-factory=org.apache.samza.config.factories.PropertiesConfigFactory --config-path=file://$PWD/deploy/samza/config/wikipedia-parser.properties
deploy/samza/bin/run-app.sh --config-factory=org.apache.samza.config.factories.PropertiesConfigFactory --config-path=file://$PWD/deploy/samza/config/wikipedia-stats.properties
-{% endhighlight %}
+```
-Once the jobs are started, you can use the same _kafka-console-consumer.sh_ command as in High-level API Wikipedia example to check out the output of the statistics.
\ No newline at end of file
+Once the jobs are started, you can use the same _kafka-console-consumer.sh_ command as in High-level API Wikipedia example to check out the output of the statistics.
+
+### Contribution
+
+To start contributing on [Hello Samza](http://samza.apache.org/startup/hello-samza/0.13/) first read [Rules](http://samza.apache.org/contribute/rules.html) and [Contributor Corner](https://cwiki.apache.org/confluence/display/SAMZA/Contributor%27s+Corner). Notice that [Hello Samza](http://samza.apache.org/startup/hello-samza/0.13/) git repository does not support git pull request.
