Update introduction and architecture - issue #96

doc/tutorials/001-introduction.md

@@ -1,7 +1,7 @@
 # Introduction
 
 MapR Music Application uses the [MusicBrainz](https://musicbrainz.org/) database to explain how to develop an 
-application with MapR Converged Data Platform.
+application with MapR Converged Data Platform with a focus on MapR-DB JSON.
 
 
 ## Contents
@@ -34,35 +34,31 @@ Contains Wildfly configuration files, which are used while building MapR Music D
 
 * [data-generator](https://github.com/mapr-demos/mapr-music/tree/master/data-generator)
 
-Utility application which allows to convert [MusicBrainz](https://musicbrainz.org/) database dump into MapR Music Data 
-Set.
+Utility application which allows to convert [MusicBrainz](https://musicbrainz.org/) database dump into MapR Music Dataset.
 
 * [dataset](https://github.com/mapr-demos/mapr-music/tree/master/dataset)
 
-Sample, ready to use MapR Music dataset.
+Sample, ready to use MapR Music dataset, generated with the script described above.
 
 * [doc](https://github.com/mapr-demos/mapr-music/tree/master/doc)
 
-Application's documentation.
+Application's documentation and tutorial.
 
 * [elasticsearch-service](https://github.com/mapr-demos/mapr-music/tree/master/elasticsearch-service)
 
-MapR Music Elastic Search Service, which listens changelogs and publishes the changes to the ElasticSearch.
+MapR Music Elasticsearch Service, which listens albums and artists table events and publishes the changes to the Elasticsearch. This service use MapR-DB Change Data Capture (CDC) feature.
 
 * [mapr-rest](https://github.com/mapr-demos/mapr-music/tree/master/mapr-rest)
 
-MapR Music REST Service, built on top of MapR-DB.
+MapR Music REST Service, built on top of MapR-DB. This Web application developped in Java use [JAX-RS](https://github.com/jax-rs) and [OJAI](https://maprdocs.mapr.com/home/MapR-DB/JSON_DB/develop-apps-jsonDB.html) to expose CRUD operations at the top of MapR-DB tables.
 
 * [mapr-ui](https://github.com/mapr-demos/mapr-music/tree/master/mapr-ui)
 
-Angular app, which provides user interface.
+[Angular](https://angular.io/) application that consume the REST APIs to allow user to browse, edit and create albums and artists.
 
 * [recommendation-engine](https://github.com/mapr-demos/mapr-music/tree/master/recommendation-engine)
 
-Recommendation Engine, built using Spark MLlib's Alternating Least Squares algorithm, which allows to make 
-Albums/Artists recommendations.
+Recommendation Engine, built using Spark MLlib's Alternating Least Squares (ALS) algorithm, to create Albums/Artists recommendations. This service uses the [MapR-DB OJAI Connector for Apache Spark](https://maprdocs.mapr.com/home/Spark/NativeSparkConnectorJSON.html) to read albums, artists ratings, and writes the recommendations back into MapR-DB.
 
 Moreover, repository contains [Dockerfile](https://github.com/mapr-demos/mapr-music/blob/master/Dockerfile), which allows 
-you to build Mapr Music Docker image, which contains properly configured Wildfly application server, 
-ElasticSearch and MapR Music components.
-
+you to build Mapr Music Docker image based on [MapR PACC](https://mapr.com/products/persistent-application-client-container/), download,configure and start: Wildfly, Elasticsearh and deploy MapR Music application.