Merge branch 'develop' of github.com:swimit/swim-platform into develop

Author: ajay-gov

README.md

@@ -6,6 +6,18 @@ Swim is a completely integrated solution for building scalable, end-to-end strea
 
 - A **user interface** that uses Swim's streaming UI frameworks to visualize data from Swim servers in real-time
 
+## Run
+
+* [Install JDK 9+](https://www.oracle.com/technetwork/java/javase/downloads/index.html).
+  * Ensure that your `JAVA_HOME` environment variable is pointed to your Java installation location.
+  * Ensure that your `PATH` includes `$JAVA_HOME`.
+
+* From a console pointed to the `server` directory, run `./gradlew run` (`.\gradlew.bat run` on Windows) to run the Swim server.
+
+* Then, open `ui/index.html` in your browser to see the UI.
+
+## How It Works
+
 Visit [server](https://github.com/swimos/tutorial/blob/master/server) to learn how to stand up your data in a Swim server.
 
-Then, visit [ui](https://github.com/swimos/tutorial/blob/master/ui) to see this data like never before.
+Then, visit [ui](https://github.com/swimos/tutorial/blob/master/ui) to learn to visualize this data like never before.

ui/README.md

@@ -0,0 +1,5 @@
+# Swim UI
+
+The minimum you need to visualize Swim data is a Swim client. That said, Swim comes with additional tools that let you see your data right away with no extra work.
+
+Read [index.html](http://github.com/swimos/tutorial/tree/master/ui/index.html) to quickstart building your own gauges, pie charts, and line graphs.